niceeval 0.12.1 → 0.12.2-canary.31

package/dist/record/model/core.d.cts

@@ -0,0 +1,53 @@
+import type { AttemptId, RecordAttachmentName, RecordAttachmentSchemaId, RecordFormatV1, RecordId, RunId, SlotId, UtcMillis } from "./identifiers.cjs";
+/** The exact contents of `record.json` for the current Record major. */
+export interface RecordDocumentV1 {
+    readonly format: RecordFormatV1;
+    readonly recordId: RecordId;
+}
+/** The exact contents of one published Run's `run.json`. */
+export interface RunDocumentV1 {
+    readonly runId: RunId;
+    readonly startedAt: UtcMillis;
+    readonly completedAt: UtcMillis;
+    readonly expectedSlots: readonly SlotId[];
+}
+/** An exact reference to an Attempt at its immutable origin. */
+export interface RecordAttemptRef {
+    readonly originRunId: RunId;
+    readonly attemptId: AttemptId;
+}
+/** The exact contents of `members/<SlotId>.json`. */
+export interface MemberDocumentV1 {
+    readonly slotId: SlotId;
+    readonly attempt: RecordAttemptRef;
+}
+/** The exact contents of `attempts/<AttemptId>/attempt.json`. */
+export interface AttemptDocumentV1 {
+    readonly attemptId: AttemptId;
+    readonly originRunId: RunId;
+}
+/** The exact contents of one Attachment's `attachment.json`. */
+export interface RecordAttachmentEnvelopeV1 {
+    readonly name: RecordAttachmentName;
+    readonly schemaId: RecordAttachmentSchemaId;
+}
+export type RecordAttachmentOwner = "run" | "attempt";
+/**
+ * Pure aggregate used to validate cross-document Core invariants. It is not a
+ * second durable document; filesystem code supplies it from one frozen view.
+ */
+export interface RunCoreV1 {
+    readonly run: RunDocumentV1;
+    readonly members: readonly MemberDocumentV1[];
+    readonly attempts: readonly AttemptDocumentV1[];
+}
+/** A complete, already-published Record Core snapshot. */
+export interface RecordCoreV1 {
+    readonly record: RecordDocumentV1;
+    readonly runs: readonly RunCoreV1[];
+}
+/**
+ * NUL cannot occur in a portable ID segment, so this is an unambiguous private
+ * map key for exact Run/Attempt references.
+ */
+export declare function recordAttemptReferenceKey(ref: RecordAttemptRef): string;

package/dist/record/model/core.d.mts

@@ -0,0 +1,53 @@
+import type { AttemptId, RecordAttachmentName, RecordAttachmentSchemaId, RecordFormatV1, RecordId, RunId, SlotId, UtcMillis } from "./identifiers.mjs";
+/** The exact contents of `record.json` for the current Record major. */
+export interface RecordDocumentV1 {
+    readonly format: RecordFormatV1;
+    readonly recordId: RecordId;
+}
+/** The exact contents of one published Run's `run.json`. */
+export interface RunDocumentV1 {
+    readonly runId: RunId;
+    readonly startedAt: UtcMillis;
+    readonly completedAt: UtcMillis;
+    readonly expectedSlots: readonly SlotId[];
+}
+/** An exact reference to an Attempt at its immutable origin. */
+export interface RecordAttemptRef {
+    readonly originRunId: RunId;
+    readonly attemptId: AttemptId;
+}
+/** The exact contents of `members/<SlotId>.json`. */
+export interface MemberDocumentV1 {
+    readonly slotId: SlotId;
+    readonly attempt: RecordAttemptRef;
+}
+/** The exact contents of `attempts/<AttemptId>/attempt.json`. */
+export interface AttemptDocumentV1 {
+    readonly attemptId: AttemptId;
+    readonly originRunId: RunId;
+}
+/** The exact contents of one Attachment's `attachment.json`. */
+export interface RecordAttachmentEnvelopeV1 {
+    readonly name: RecordAttachmentName;
+    readonly schemaId: RecordAttachmentSchemaId;
+}
+export type RecordAttachmentOwner = "run" | "attempt";
+/**
+ * Pure aggregate used to validate cross-document Core invariants. It is not a
+ * second durable document; filesystem code supplies it from one frozen view.
+ */
+export interface RunCoreV1 {
+    readonly run: RunDocumentV1;
+    readonly members: readonly MemberDocumentV1[];
+    readonly attempts: readonly AttemptDocumentV1[];
+}
+/** A complete, already-published Record Core snapshot. */
+export interface RecordCoreV1 {
+    readonly record: RecordDocumentV1;
+    readonly runs: readonly RunCoreV1[];
+}
+/**
+ * NUL cannot occur in a portable ID segment, so this is an unambiguous private
+ * map key for exact Run/Attempt references.
+ */
+export declare function recordAttemptReferenceKey(ref: RecordAttemptRef): string;

package/dist/record/model/core.d.ts

@@ -0,0 +1,53 @@
+import type { AttemptId, RecordAttachmentName, RecordAttachmentSchemaId, RecordFormatV1, RecordId, RunId, SlotId, UtcMillis } from "./identifiers.js";
+/** The exact contents of `record.json` for the current Record major. */
+export interface RecordDocumentV1 {
+    readonly format: RecordFormatV1;
+    readonly recordId: RecordId;
+}
+/** The exact contents of one published Run's `run.json`. */
+export interface RunDocumentV1 {
+    readonly runId: RunId;
+    readonly startedAt: UtcMillis;
+    readonly completedAt: UtcMillis;
+    readonly expectedSlots: readonly SlotId[];
+}
+/** An exact reference to an Attempt at its immutable origin. */
+export interface RecordAttemptRef {
+    readonly originRunId: RunId;
+    readonly attemptId: AttemptId;
+}
+/** The exact contents of `members/<SlotId>.json`. */
+export interface MemberDocumentV1 {
+    readonly slotId: SlotId;
+    readonly attempt: RecordAttemptRef;
+}
+/** The exact contents of `attempts/<AttemptId>/attempt.json`. */
+export interface AttemptDocumentV1 {
+    readonly attemptId: AttemptId;
+    readonly originRunId: RunId;
+}
+/** The exact contents of one Attachment's `attachment.json`. */
+export interface RecordAttachmentEnvelopeV1 {
+    readonly name: RecordAttachmentName;
+    readonly schemaId: RecordAttachmentSchemaId;
+}
+export type RecordAttachmentOwner = "run" | "attempt";
+/**
+ * Pure aggregate used to validate cross-document Core invariants. It is not a
+ * second durable document; filesystem code supplies it from one frozen view.
+ */
+export interface RunCoreV1 {
+    readonly run: RunDocumentV1;
+    readonly members: readonly MemberDocumentV1[];
+    readonly attempts: readonly AttemptDocumentV1[];
+}
+/** A complete, already-published Record Core snapshot. */
+export interface RecordCoreV1 {
+    readonly record: RecordDocumentV1;
+    readonly runs: readonly RunCoreV1[];
+}
+/**
+ * NUL cannot occur in a portable ID segment, so this is an unambiguous private
+ * map key for exact Run/Attempt references.
+ */
+export declare function recordAttemptReferenceKey(ref: RecordAttemptRef): string;

package/dist/record/model/core.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./core.cjs");
+const __niceevalExport0 = __niceevalCanonical["recordAttemptReferenceKey"];
+export { __niceevalExport0 as recordAttemptReferenceKey };
+//# sourceMappingURL=core.js.map

package/dist/record/model/core.js.map

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

package/dist/record/model/identifiers.cjs

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECORD_FORMAT_V1 = exports.RECORD_FORMAT_ID_BRAND = exports.RECORD_ATTACHMENT_SCHEMA_ID_BRAND = exports.RECORD_ATTACHMENT_NAME_BRAND = exports.UTC_MILLIS_BRAND = exports.ATTEMPT_ID_BRAND = exports.SLOT_ID_BRAND = exports.RUN_ID_BRAND = exports.RECORD_ID_BRAND = void 0;
+exports.isPortableSegment = isPortableSegment;
+exports.compareCanonicalIdentity = compareCanonicalIdentity;
+exports.isUtcMillis = isUtcMillis;
+exports.isRecordAttachmentName = isRecordAttachmentName;
+exports.parseRecordAttachmentSchemaId = parseRecordAttachmentSchemaId;
+exports.isRecordAttachmentSchemaId = isRecordAttachmentSchemaId;
+exports.recordAttachmentNameTextOfSchemaId = recordAttachmentNameTextOfSchemaId;
+exports.isRecordFormatId = isRecordFormatId;
+exports.isNiceEvalRecordAttachmentName = isNiceEvalRecordAttachmentName;
+/**
+ * Brand identifiers are deliberately package-local names. Their runtime values
+ * remain portable strings; construction belongs to the exact codecs.
+ */
+exports.RECORD_ID_BRAND = "@niceeval/record/RecordId";
+exports.RUN_ID_BRAND = "@niceeval/record/RunId";
+exports.SLOT_ID_BRAND = "@niceeval/record/SlotId";
+exports.ATTEMPT_ID_BRAND = "@niceeval/record/AttemptId";
+exports.UTC_MILLIS_BRAND = "@niceeval/record/UtcMillis";
+exports.RECORD_ATTACHMENT_NAME_BRAND = "@niceeval/record/RecordAttachmentName";
+exports.RECORD_ATTACHMENT_SCHEMA_ID_BRAND = "@niceeval/record/RecordAttachmentSchemaId";
+exports.RECORD_FORMAT_ID_BRAND = "@niceeval/record/RecordFormatId";
+exports.RECORD_FORMAT_V1 = "niceeval.record/v1";
+const PORTABLE_SEGMENT_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,253}[A-Za-z0-9])?$/;
+const WINDOWS_RESERVED_SEGMENT_PATTERN = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+const RECORD_ATTACHMENT_LABEL = "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?";
+const RECORD_ATTACHMENT_NAME_PATTERN = new RegExp(`^(?:${RECORD_ATTACHMENT_LABEL}\\.)+${RECORD_ATTACHMENT_LABEL}$`);
+const RECORD_ATTACHMENT_SCHEMA_ID_PATTERN = new RegExp(`^(${RECORD_ATTACHMENT_LABEL}(?:\\.${RECORD_ATTACHMENT_LABEL})*)/v([1-9][0-9]*)$`);
+const RECORD_FORMAT_ID_PATTERN = /^niceeval\.record\/v[1-9][0-9]*$/;
+/**
+ * A file-name segment that is safe to copy between the supported Record roots.
+ * It is ASCII-only, has no platform separator, and excludes DOS device names.
+ */
+function isPortableSegment(value) {
+    return (PORTABLE_SEGMENT_PATTERN.test(value) &&
+        !WINDOWS_RESERVED_SEGMENT_PATTERN.test(value));
+}
+/** Canonical identity ordering is ASCII code-unit ordering, never locale order. */
+function compareCanonicalIdentity(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+/** Unix-epoch milliseconds that can round-trip through a JSON number exactly. */
+function isUtcMillis(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+/** A RecordAttachment directory name is a lowercase reverse-domain namespace. */
+function isRecordAttachmentName(value) {
+    return (value.length <= 255 &&
+        isPortableSegment(value) &&
+        RECORD_ATTACHMENT_NAME_PATTERN.test(value));
+}
+/** Parses the durable `<reverse-domain-name>/vN` identity without minting a brand. */
+function parseRecordAttachmentSchemaId(value) {
+    const match = RECORD_ATTACHMENT_SCHEMA_ID_PATTERN.exec(value);
+    if (match === null) {
+        return undefined;
+    }
+    return { name: match[1], version: match[2] };
+}
+function isRecordAttachmentSchemaId(value) {
+    const parts = parseRecordAttachmentSchemaId(value);
+    return parts !== undefined && isRecordAttachmentName(parts.name);
+}
+function recordAttachmentNameTextOfSchemaId(schemaId) {
+    return parseRecordAttachmentSchemaId(schemaId)?.name;
+}
+function isRecordFormatId(value) {
+    return RECORD_FORMAT_ID_PATTERN.test(value);
+}
+function isNiceEvalRecordAttachmentName(name) {
+    return name.startsWith("niceeval.");
+}
+//# sourceMappingURL=identifiers.cjs.map

package/dist/record/model/identifiers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["identifiers.ts"],"names":[],"mappings":";;;AAiCA,8CAGC;AAED,4DAKC;AAED,kCAEC;AAED,wDAIC;AAMD,sEAMC;AACD,gEAGC;AACD,gFAEC;AACD,4CAEC;AACD,wEAEC;AA7ED;;;GAGG;AACU,QAAA,eAAe,GAAG,2BAAoC,CAAC;AACvD,QAAA,YAAY,GAAG,wBAAiC,CAAC;AACjD,QAAA,aAAa,GAAG,yBAAkC,CAAC;AACnD,QAAA,gBAAgB,GAAG,4BAAqC,CAAC;AACzD,QAAA,gBAAgB,GAAG,4BAAqC,CAAC;AACzD,QAAA,4BAA4B,GAAG,uCAAgD,CAAC;AAChF,QAAA,iCAAiC,GAAG,2CAAoD,CAAC;AACzF,QAAA,sBAAsB,GAAG,iCAA0C,CAAC;AASpE,QAAA,gBAAgB,GAAG,oBAA6B,CAAC;AAE9D,MAAM,wBAAwB,GAAG,oDAAoD,CAAC;AACtF,MAAM,gCAAgC,GAAG,mDAAmD,CAAC;AAC7F,MAAM,uBAAuB,GAAG,sCAAsC,CAAC;AACvE,MAAM,8BAA8B,GAAG,IAAI,MAAM,CAAC,OAAO,uBAAuB,QAAQ,uBAAuB,GAAG,CAAC,CAAC;AACpH,MAAM,mCAAmC,GAAG,IAAI,MAAM,CAAC,KAAK,uBAAuB,SAAS,uBAAuB,qBAAqB,CAAC,CAAC;AAC1I,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AACpE;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC3C,OAAO,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACxC,CAAC,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC;AACD,mFAAmF;AACnF,SAAgB,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAChE,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACb,CAAC;IACD,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AACD,iFAAiF;AACjF,SAAgB,WAAW,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC;AACD,iFAAiF;AACjF,SAAgB,sBAAsB,CAAC,KAAa;IAChD,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,GAAG;QACvB,iBAAiB,CAAC,KAAK,CAAC;QACxB,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAKD,sFAAsF;AACtF,SAAgB,6BAA6B,CAAC,KAAa;IACvD,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AACD,SAAgB,0BAA0B,CAAC,KAAa;IACpD,MAAM,KAAK,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO,KAAK,KAAK,SAAS,IAAI,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AACD,SAAgB,kCAAkC,CAAC,QAAgB;IAC/D,OAAO,6BAA6B,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;AACzD,CAAC;AACD,SAAgB,gBAAgB,CAAC,KAAa;IAC1C,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AACD,SAAgB,8BAA8B,CAAC,IAA0B;IACrE,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import type { Brand } from \"effect\";\n/**\n * Brand identifiers are deliberately package-local names. Their runtime values\n * remain portable strings; construction belongs to the exact codecs.\n */\nexport const RECORD_ID_BRAND = \"@niceeval/record/RecordId\" as const;\nexport const RUN_ID_BRAND = \"@niceeval/record/RunId\" as const;\nexport const SLOT_ID_BRAND = \"@niceeval/record/SlotId\" as const;\nexport const ATTEMPT_ID_BRAND = \"@niceeval/record/AttemptId\" as const;\nexport const UTC_MILLIS_BRAND = \"@niceeval/record/UtcMillis\" as const;\nexport const RECORD_ATTACHMENT_NAME_BRAND = \"@niceeval/record/RecordAttachmentName\" as const;\nexport const RECORD_ATTACHMENT_SCHEMA_ID_BRAND = \"@niceeval/record/RecordAttachmentSchemaId\" as const;\nexport const RECORD_FORMAT_ID_BRAND = \"@niceeval/record/RecordFormatId\" as const;\nexport type RecordId = string & Brand.Brand<typeof RECORD_ID_BRAND>;\nexport type RunId = string & Brand.Brand<typeof RUN_ID_BRAND>;\nexport type SlotId = string & Brand.Brand<typeof SLOT_ID_BRAND>;\nexport type AttemptId = string & Brand.Brand<typeof ATTEMPT_ID_BRAND>;\nexport type UtcMillis = number & Brand.Brand<typeof UTC_MILLIS_BRAND>;\nexport type RecordAttachmentName = string & Brand.Brand<typeof RECORD_ATTACHMENT_NAME_BRAND>;\nexport type RecordAttachmentSchemaId = string & Brand.Brand<typeof RECORD_ATTACHMENT_SCHEMA_ID_BRAND>;\nexport type RecordFormatId = string & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;\nexport const RECORD_FORMAT_V1 = \"niceeval.record/v1\" as const;\nexport type RecordFormatV1 = typeof RECORD_FORMAT_V1 & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;\nconst PORTABLE_SEGMENT_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,253}[A-Za-z0-9])?$/;\nconst WINDOWS_RESERVED_SEGMENT_PATTERN = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\\..*)?$/i;\nconst RECORD_ATTACHMENT_LABEL = \"[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\";\nconst RECORD_ATTACHMENT_NAME_PATTERN = new RegExp(`^(?:${RECORD_ATTACHMENT_LABEL}\\\\.)+${RECORD_ATTACHMENT_LABEL}$`);\nconst RECORD_ATTACHMENT_SCHEMA_ID_PATTERN = new RegExp(`^(${RECORD_ATTACHMENT_LABEL}(?:\\\\.${RECORD_ATTACHMENT_LABEL})*)/v([1-9][0-9]*)$`);\nconst RECORD_FORMAT_ID_PATTERN = /^niceeval\\.record\\/v[1-9][0-9]*$/;\n/**\n * A file-name segment that is safe to copy between the supported Record roots.\n * It is ASCII-only, has no platform separator, and excludes DOS device names.\n */\nexport function isPortableSegment(value: string): boolean {\n    return (PORTABLE_SEGMENT_PATTERN.test(value) &&\n        !WINDOWS_RESERVED_SEGMENT_PATTERN.test(value));\n}\n/** Canonical identity ordering is ASCII code-unit ordering, never locale order. */\nexport function compareCanonicalIdentity(left: string, right: string): number {\n    if (left === right) {\n        return 0;\n    }\n    return left < right ? -1 : 1;\n}\n/** Unix-epoch milliseconds that can round-trip through a JSON number exactly. */\nexport function isUtcMillis(value: number): boolean {\n    return Number.isSafeInteger(value) && value >= 0;\n}\n/** A RecordAttachment directory name is a lowercase reverse-domain namespace. */\nexport function isRecordAttachmentName(value: string): boolean {\n    return (value.length <= 255 &&\n        isPortableSegment(value) &&\n        RECORD_ATTACHMENT_NAME_PATTERN.test(value));\n}\nexport interface RecordAttachmentSchemaIdParts {\n    readonly name: string;\n    readonly version: string;\n}\n/** Parses the durable `<reverse-domain-name>/vN` identity without minting a brand. */\nexport function parseRecordAttachmentSchemaId(value: string): RecordAttachmentSchemaIdParts | undefined {\n    const match = RECORD_ATTACHMENT_SCHEMA_ID_PATTERN.exec(value);\n    if (match === null) {\n        return undefined;\n    }\n    return { name: match[1], version: match[2] };\n}\nexport function isRecordAttachmentSchemaId(value: string): boolean {\n    const parts = parseRecordAttachmentSchemaId(value);\n    return parts !== undefined && isRecordAttachmentName(parts.name);\n}\nexport function recordAttachmentNameTextOfSchemaId(schemaId: string): string | undefined {\n    return parseRecordAttachmentSchemaId(schemaId)?.name;\n}\nexport function isRecordFormatId(value: string): boolean {\n    return RECORD_FORMAT_ID_PATTERN.test(value);\n}\nexport function isNiceEvalRecordAttachmentName(name: RecordAttachmentName): boolean {\n    return name.startsWith(\"niceeval.\");\n}\n"]}

package/dist/record/model/identifiers.d.cts

@@ -0,0 +1,44 @@
+import type { Brand } from "effect";
+/**
+ * Brand identifiers are deliberately package-local names. Their runtime values
+ * remain portable strings; construction belongs to the exact codecs.
+ */
+export declare const RECORD_ID_BRAND: "@niceeval/record/RecordId";
+export declare const RUN_ID_BRAND: "@niceeval/record/RunId";
+export declare const SLOT_ID_BRAND: "@niceeval/record/SlotId";
+export declare const ATTEMPT_ID_BRAND: "@niceeval/record/AttemptId";
+export declare const UTC_MILLIS_BRAND: "@niceeval/record/UtcMillis";
+export declare const RECORD_ATTACHMENT_NAME_BRAND: "@niceeval/record/RecordAttachmentName";
+export declare const RECORD_ATTACHMENT_SCHEMA_ID_BRAND: "@niceeval/record/RecordAttachmentSchemaId";
+export declare const RECORD_FORMAT_ID_BRAND: "@niceeval/record/RecordFormatId";
+export type RecordId = string & Brand.Brand<typeof RECORD_ID_BRAND>;
+export type RunId = string & Brand.Brand<typeof RUN_ID_BRAND>;
+export type SlotId = string & Brand.Brand<typeof SLOT_ID_BRAND>;
+export type AttemptId = string & Brand.Brand<typeof ATTEMPT_ID_BRAND>;
+export type UtcMillis = number & Brand.Brand<typeof UTC_MILLIS_BRAND>;
+export type RecordAttachmentName = string & Brand.Brand<typeof RECORD_ATTACHMENT_NAME_BRAND>;
+export type RecordAttachmentSchemaId = string & Brand.Brand<typeof RECORD_ATTACHMENT_SCHEMA_ID_BRAND>;
+export type RecordFormatId = string & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+export declare const RECORD_FORMAT_V1: "niceeval.record/v1";
+export type RecordFormatV1 = typeof RECORD_FORMAT_V1 & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+/**
+ * A file-name segment that is safe to copy between the supported Record roots.
+ * It is ASCII-only, has no platform separator, and excludes DOS device names.
+ */
+export declare function isPortableSegment(value: string): boolean;
+/** Canonical identity ordering is ASCII code-unit ordering, never locale order. */
+export declare function compareCanonicalIdentity(left: string, right: string): number;
+/** Unix-epoch milliseconds that can round-trip through a JSON number exactly. */
+export declare function isUtcMillis(value: number): boolean;
+/** A RecordAttachment directory name is a lowercase reverse-domain namespace. */
+export declare function isRecordAttachmentName(value: string): boolean;
+export interface RecordAttachmentSchemaIdParts {
+    readonly name: string;
+    readonly version: string;
+}
+/** Parses the durable `<reverse-domain-name>/vN` identity without minting a brand. */
+export declare function parseRecordAttachmentSchemaId(value: string): RecordAttachmentSchemaIdParts | undefined;
+export declare function isRecordAttachmentSchemaId(value: string): boolean;
+export declare function recordAttachmentNameTextOfSchemaId(schemaId: string): string | undefined;
+export declare function isRecordFormatId(value: string): boolean;
+export declare function isNiceEvalRecordAttachmentName(name: RecordAttachmentName): boolean;

package/dist/record/model/identifiers.d.mts

@@ -0,0 +1,44 @@
+import type { Brand } from "effect";
+/**
+ * Brand identifiers are deliberately package-local names. Their runtime values
+ * remain portable strings; construction belongs to the exact codecs.
+ */
+export declare const RECORD_ID_BRAND: "@niceeval/record/RecordId";
+export declare const RUN_ID_BRAND: "@niceeval/record/RunId";
+export declare const SLOT_ID_BRAND: "@niceeval/record/SlotId";
+export declare const ATTEMPT_ID_BRAND: "@niceeval/record/AttemptId";
+export declare const UTC_MILLIS_BRAND: "@niceeval/record/UtcMillis";
+export declare const RECORD_ATTACHMENT_NAME_BRAND: "@niceeval/record/RecordAttachmentName";
+export declare const RECORD_ATTACHMENT_SCHEMA_ID_BRAND: "@niceeval/record/RecordAttachmentSchemaId";
+export declare const RECORD_FORMAT_ID_BRAND: "@niceeval/record/RecordFormatId";
+export type RecordId = string & Brand.Brand<typeof RECORD_ID_BRAND>;
+export type RunId = string & Brand.Brand<typeof RUN_ID_BRAND>;
+export type SlotId = string & Brand.Brand<typeof SLOT_ID_BRAND>;
+export type AttemptId = string & Brand.Brand<typeof ATTEMPT_ID_BRAND>;
+export type UtcMillis = number & Brand.Brand<typeof UTC_MILLIS_BRAND>;
+export type RecordAttachmentName = string & Brand.Brand<typeof RECORD_ATTACHMENT_NAME_BRAND>;
+export type RecordAttachmentSchemaId = string & Brand.Brand<typeof RECORD_ATTACHMENT_SCHEMA_ID_BRAND>;
+export type RecordFormatId = string & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+export declare const RECORD_FORMAT_V1: "niceeval.record/v1";
+export type RecordFormatV1 = typeof RECORD_FORMAT_V1 & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+/**
+ * A file-name segment that is safe to copy between the supported Record roots.
+ * It is ASCII-only, has no platform separator, and excludes DOS device names.
+ */
+export declare function isPortableSegment(value: string): boolean;
+/** Canonical identity ordering is ASCII code-unit ordering, never locale order. */
+export declare function compareCanonicalIdentity(left: string, right: string): number;
+/** Unix-epoch milliseconds that can round-trip through a JSON number exactly. */
+export declare function isUtcMillis(value: number): boolean;
+/** A RecordAttachment directory name is a lowercase reverse-domain namespace. */
+export declare function isRecordAttachmentName(value: string): boolean;
+export interface RecordAttachmentSchemaIdParts {
+    readonly name: string;
+    readonly version: string;
+}
+/** Parses the durable `<reverse-domain-name>/vN` identity without minting a brand. */
+export declare function parseRecordAttachmentSchemaId(value: string): RecordAttachmentSchemaIdParts | undefined;
+export declare function isRecordAttachmentSchemaId(value: string): boolean;
+export declare function recordAttachmentNameTextOfSchemaId(schemaId: string): string | undefined;
+export declare function isRecordFormatId(value: string): boolean;
+export declare function isNiceEvalRecordAttachmentName(name: RecordAttachmentName): boolean;

package/dist/record/model/identifiers.d.ts

@@ -0,0 +1,44 @@
+import type { Brand } from "effect";
+/**
+ * Brand identifiers are deliberately package-local names. Their runtime values
+ * remain portable strings; construction belongs to the exact codecs.
+ */
+export declare const RECORD_ID_BRAND: "@niceeval/record/RecordId";
+export declare const RUN_ID_BRAND: "@niceeval/record/RunId";
+export declare const SLOT_ID_BRAND: "@niceeval/record/SlotId";
+export declare const ATTEMPT_ID_BRAND: "@niceeval/record/AttemptId";
+export declare const UTC_MILLIS_BRAND: "@niceeval/record/UtcMillis";
+export declare const RECORD_ATTACHMENT_NAME_BRAND: "@niceeval/record/RecordAttachmentName";
+export declare const RECORD_ATTACHMENT_SCHEMA_ID_BRAND: "@niceeval/record/RecordAttachmentSchemaId";
+export declare const RECORD_FORMAT_ID_BRAND: "@niceeval/record/RecordFormatId";
+export type RecordId = string & Brand.Brand<typeof RECORD_ID_BRAND>;
+export type RunId = string & Brand.Brand<typeof RUN_ID_BRAND>;
+export type SlotId = string & Brand.Brand<typeof SLOT_ID_BRAND>;
+export type AttemptId = string & Brand.Brand<typeof ATTEMPT_ID_BRAND>;
+export type UtcMillis = number & Brand.Brand<typeof UTC_MILLIS_BRAND>;
+export type RecordAttachmentName = string & Brand.Brand<typeof RECORD_ATTACHMENT_NAME_BRAND>;
+export type RecordAttachmentSchemaId = string & Brand.Brand<typeof RECORD_ATTACHMENT_SCHEMA_ID_BRAND>;
+export type RecordFormatId = string & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+export declare const RECORD_FORMAT_V1: "niceeval.record/v1";
+export type RecordFormatV1 = typeof RECORD_FORMAT_V1 & Brand.Brand<typeof RECORD_FORMAT_ID_BRAND>;
+/**
+ * A file-name segment that is safe to copy between the supported Record roots.
+ * It is ASCII-only, has no platform separator, and excludes DOS device names.
+ */
+export declare function isPortableSegment(value: string): boolean;
+/** Canonical identity ordering is ASCII code-unit ordering, never locale order. */
+export declare function compareCanonicalIdentity(left: string, right: string): number;
+/** Unix-epoch milliseconds that can round-trip through a JSON number exactly. */
+export declare function isUtcMillis(value: number): boolean;
+/** A RecordAttachment directory name is a lowercase reverse-domain namespace. */
+export declare function isRecordAttachmentName(value: string): boolean;
+export interface RecordAttachmentSchemaIdParts {
+    readonly name: string;
+    readonly version: string;
+}
+/** Parses the durable `<reverse-domain-name>/vN` identity without minting a brand. */
+export declare function parseRecordAttachmentSchemaId(value: string): RecordAttachmentSchemaIdParts | undefined;
+export declare function isRecordAttachmentSchemaId(value: string): boolean;
+export declare function recordAttachmentNameTextOfSchemaId(schemaId: string): string | undefined;
+export declare function isRecordFormatId(value: string): boolean;
+export declare function isNiceEvalRecordAttachmentName(name: RecordAttachmentName): boolean;

package/dist/record/model/identifiers.js

@@ -0,0 +1,40 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./identifiers.cjs");
+const __niceevalExport0 = __niceevalCanonical["ATTEMPT_ID_BRAND"];
+export { __niceevalExport0 as ATTEMPT_ID_BRAND };
+const __niceevalExport1 = __niceevalCanonical["RECORD_ATTACHMENT_NAME_BRAND"];
+export { __niceevalExport1 as RECORD_ATTACHMENT_NAME_BRAND };
+const __niceevalExport2 = __niceevalCanonical["RECORD_ATTACHMENT_SCHEMA_ID_BRAND"];
+export { __niceevalExport2 as RECORD_ATTACHMENT_SCHEMA_ID_BRAND };
+const __niceevalExport3 = __niceevalCanonical["RECORD_FORMAT_ID_BRAND"];
+export { __niceevalExport3 as RECORD_FORMAT_ID_BRAND };
+const __niceevalExport4 = __niceevalCanonical["RECORD_FORMAT_V1"];
+export { __niceevalExport4 as RECORD_FORMAT_V1 };
+const __niceevalExport5 = __niceevalCanonical["RECORD_ID_BRAND"];
+export { __niceevalExport5 as RECORD_ID_BRAND };
+const __niceevalExport6 = __niceevalCanonical["RUN_ID_BRAND"];
+export { __niceevalExport6 as RUN_ID_BRAND };
+const __niceevalExport7 = __niceevalCanonical["SLOT_ID_BRAND"];
+export { __niceevalExport7 as SLOT_ID_BRAND };
+const __niceevalExport8 = __niceevalCanonical["UTC_MILLIS_BRAND"];
+export { __niceevalExport8 as UTC_MILLIS_BRAND };
+const __niceevalExport9 = __niceevalCanonical["compareCanonicalIdentity"];
+export { __niceevalExport9 as compareCanonicalIdentity };
+const __niceevalExport10 = __niceevalCanonical["isNiceEvalRecordAttachmentName"];
+export { __niceevalExport10 as isNiceEvalRecordAttachmentName };
+const __niceevalExport11 = __niceevalCanonical["isPortableSegment"];
+export { __niceevalExport11 as isPortableSegment };
+const __niceevalExport12 = __niceevalCanonical["isRecordAttachmentName"];
+export { __niceevalExport12 as isRecordAttachmentName };
+const __niceevalExport13 = __niceevalCanonical["isRecordAttachmentSchemaId"];
+export { __niceevalExport13 as isRecordAttachmentSchemaId };
+const __niceevalExport14 = __niceevalCanonical["isRecordFormatId"];
+export { __niceevalExport14 as isRecordFormatId };
+const __niceevalExport15 = __niceevalCanonical["isUtcMillis"];
+export { __niceevalExport15 as isUtcMillis };
+const __niceevalExport16 = __niceevalCanonical["parseRecordAttachmentSchemaId"];
+export { __niceevalExport16 as parseRecordAttachmentSchemaId };
+const __niceevalExport17 = __niceevalCanonical["recordAttachmentNameTextOfSchemaId"];
+export { __niceevalExport17 as recordAttachmentNameTextOfSchemaId };
+//# sourceMappingURL=identifiers.js.map

package/dist/record/model/identifiers.js.map

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

package/dist/record/model/index.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core.cjs"), exports);
+__exportStar(require("./identifiers.cjs"), exports);
+__exportStar(require("./read-state.cjs"), exports);
+__exportStar(require("./validation.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,mDAAiC;AACjC,kDAAgC;AAChC,kDAAgC","sourcesContent":["export * from \"./core.ts\";\nexport * from \"./identifiers.ts\";\nexport * from \"./read-state.ts\";\nexport * from \"./validation.ts\";\n"]}

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

@@ -0,0 +1,4 @@
+export * from "./core.cjs";
+export * from "./identifiers.cjs";
+export * from "./read-state.cjs";
+export * from "./validation.cjs";

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

@@ -0,0 +1,4 @@
+export * from "./core.mjs";
+export * from "./identifiers.mjs";
+export * from "./read-state.mjs";
+export * from "./validation.mjs";

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

@@ -0,0 +1,4 @@
+export * from "./core.js";
+export * from "./identifiers.js";
+export * from "./read-state.js";
+export * from "./validation.js";

package/dist/record/model/index.js

@@ -0,0 +1,52 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./index.cjs");
+const __niceevalExport0 = __niceevalCanonical["ATTEMPT_ID_BRAND"];
+export { __niceevalExport0 as ATTEMPT_ID_BRAND };
+const __niceevalExport1 = __niceevalCanonical["RECORD_ATTACHMENT_NAME_BRAND"];
+export { __niceevalExport1 as RECORD_ATTACHMENT_NAME_BRAND };
+const __niceevalExport2 = __niceevalCanonical["RECORD_ATTACHMENT_SCHEMA_ID_BRAND"];
+export { __niceevalExport2 as RECORD_ATTACHMENT_SCHEMA_ID_BRAND };
+const __niceevalExport3 = __niceevalCanonical["RECORD_FORMAT_ID_BRAND"];
+export { __niceevalExport3 as RECORD_FORMAT_ID_BRAND };
+const __niceevalExport4 = __niceevalCanonical["RECORD_FORMAT_V1"];
+export { __niceevalExport4 as RECORD_FORMAT_V1 };
+const __niceevalExport5 = __niceevalCanonical["RECORD_ID_BRAND"];
+export { __niceevalExport5 as RECORD_ID_BRAND };
+const __niceevalExport6 = __niceevalCanonical["RUN_ID_BRAND"];
+export { __niceevalExport6 as RUN_ID_BRAND };
+const __niceevalExport7 = __niceevalCanonical["SLOT_ID_BRAND"];
+export { __niceevalExport7 as SLOT_ID_BRAND };
+const __niceevalExport8 = __niceevalCanonical["UTC_MILLIS_BRAND"];
+export { __niceevalExport8 as UTC_MILLIS_BRAND };
+const __niceevalExport9 = __niceevalCanonical["compareCanonicalIdentity"];
+export { __niceevalExport9 as compareCanonicalIdentity };
+const __niceevalExport10 = __niceevalCanonical["isNiceEvalRecordAttachmentName"];
+export { __niceevalExport10 as isNiceEvalRecordAttachmentName };
+const __niceevalExport11 = __niceevalCanonical["isPortableSegment"];
+export { __niceevalExport11 as isPortableSegment };
+const __niceevalExport12 = __niceevalCanonical["isRecordAttachmentName"];
+export { __niceevalExport12 as isRecordAttachmentName };
+const __niceevalExport13 = __niceevalCanonical["isRecordAttachmentSchemaId"];
+export { __niceevalExport13 as isRecordAttachmentSchemaId };
+const __niceevalExport14 = __niceevalCanonical["isRecordFormatId"];
+export { __niceevalExport14 as isRecordFormatId };
+const __niceevalExport15 = __niceevalCanonical["isUtcMillis"];
+export { __niceevalExport15 as isUtcMillis };
+const __niceevalExport16 = __niceevalCanonical["nonEmptyRecordIssues"];
+export { __niceevalExport16 as nonEmptyRecordIssues };
+const __niceevalExport17 = __niceevalCanonical["parseRecordAttachmentSchemaId"];
+export { __niceevalExport17 as parseRecordAttachmentSchemaId };
+const __niceevalExport18 = __niceevalCanonical["recordAttachmentNameTextOfSchemaId"];
+export { __niceevalExport18 as recordAttachmentNameTextOfSchemaId };
+const __niceevalExport19 = __niceevalCanonical["recordAttemptReferenceKey"];
+export { __niceevalExport19 as recordAttemptReferenceKey };
+const __niceevalExport20 = __niceevalCanonical["validateExpectedSlots"];
+export { __niceevalExport20 as validateExpectedSlots };
+const __niceevalExport21 = __niceevalCanonical["validateRecordAttachmentEnvelopeV1"];
+export { __niceevalExport21 as validateRecordAttachmentEnvelopeV1 };
+const __niceevalExport22 = __niceevalCanonical["validateRecordCoreV1"];
+export { __niceevalExport22 as validateRecordCoreV1 };
+const __niceevalExport23 = __niceevalCanonical["validateRunDocumentV1"];
+export { __niceevalExport23 as validateRunDocumentV1 };
+//# sourceMappingURL=index.js.map

package/dist/record/model/index.js.map

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

package/dist/record/model/read-state.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=read-state.cjs.map

package/dist/record/model/read-state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-state.js","sourceRoot":"","sources":["read-state.ts"],"names":[],"mappings":"","sourcesContent":["import type { RecordAttachmentSchemaId, RunId, } from \"./identifiers.ts\";\nimport type { NonEmptyRecordIssues } from \"../errors/record-errors.ts\";\n/** Core corruption is represented as readable state, not an Effect failure. */\nexport type RecordCoreRead<Value> = {\n    readonly state: \"available\";\n    readonly value: Value;\n} | {\n    readonly state: \"missing\";\n} | {\n    readonly state: \"core-invalid\";\n    readonly issues: NonEmptyRecordIssues;\n};\n/**\n * Attachment state is independent from Core state. `Value` is intentionally\n * generic so the later materialized blob snapshot can be introduced without\n * changing this state machine.\n */\nexport type RecordAttachmentRead<Value> = {\n    readonly state: \"available\";\n    readonly value: Value;\n} | {\n    readonly state: \"unavailable\";\n} | {\n    readonly state: \"migration-required\";\n    readonly from: RecordAttachmentSchemaId;\n    readonly to: RecordAttachmentSchemaId;\n    readonly command: \"niceeval migrate\";\n} | {\n    readonly state: \"migration-unavailable\";\n    readonly from: RecordAttachmentSchemaId;\n    readonly to: RecordAttachmentSchemaId;\n    readonly reason: string;\n} | {\n    readonly state: \"unsupported\";\n    readonly schemaId: RecordAttachmentSchemaId;\n} | {\n    readonly state: \"invalid\";\n    readonly issues: NonEmptyRecordIssues;\n};\nexport interface RecordIncompleteRunWarning {\n    readonly code: \"incomplete-run\";\n    readonly runId: RunId;\n    readonly cleanupCommand: \"niceeval clean\";\n}\nexport type RecordWarning = RecordIncompleteRunWarning;\n"]}

package/dist/record/model/read-state.d.cts

@@ -0,0 +1,45 @@
+import type { RecordAttachmentSchemaId, RunId } from "./identifiers.cjs";
+import type { NonEmptyRecordIssues } from "../errors/record-errors.cjs";
+/** Core corruption is represented as readable state, not an Effect failure. */
+export type RecordCoreRead<Value> = {
+    readonly state: "available";
+    readonly value: Value;
+} | {
+    readonly state: "missing";
+} | {
+    readonly state: "core-invalid";
+    readonly issues: NonEmptyRecordIssues;
+};
+/**
+ * Attachment state is independent from Core state. `Value` is intentionally
+ * generic so the later materialized blob snapshot can be introduced without
+ * changing this state machine.
+ */
+export type RecordAttachmentRead<Value> = {
+    readonly state: "available";
+    readonly value: Value;
+} | {
+    readonly state: "unavailable";
+} | {
+    readonly state: "migration-required";
+    readonly from: RecordAttachmentSchemaId;
+    readonly to: RecordAttachmentSchemaId;
+    readonly command: "niceeval migrate";
+} | {
+    readonly state: "migration-unavailable";
+    readonly from: RecordAttachmentSchemaId;
+    readonly to: RecordAttachmentSchemaId;
+    readonly reason: string;
+} | {
+    readonly state: "unsupported";
+    readonly schemaId: RecordAttachmentSchemaId;
+} | {
+    readonly state: "invalid";
+    readonly issues: NonEmptyRecordIssues;
+};
+export interface RecordIncompleteRunWarning {
+    readonly code: "incomplete-run";
+    readonly runId: RunId;
+    readonly cleanupCommand: "niceeval clean";
+}
+export type RecordWarning = RecordIncompleteRunWarning;