@marinoscar/kvox-eval 0.0.0-bootstrap → 0.1.0-next.0

package/dist/fixtures/fixture-schema.d.ts

@@ -0,0 +1,323 @@
+import { z } from 'zod';
+/**
+ * One citation of a gold label: a transcript segment and a verbatim quote from it,
+ * or a verbatim quote from the note body.
+ *
+ * @stability experimental
+ */
+export declare const evidenceLabelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodLiteral<"segment">;
+    segmentId: z.ZodString;
+    quote: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"note">;
+    quote: z.ZodString;
+}, z.core.$strip>], "source">;
+/**
+ * A parsed {@link evidenceLabelSchema}.
+ *
+ * @stability experimental
+ */
+export type EvidenceLabel = z.infer<typeof evidenceLabelSchema>;
+/**
+ * The precision of a temporal label (docs/specs/ontology.md §5.4): `unknown` means both bounds are `null`.
+ *
+ * @stability experimental
+ */
+export declare const validPrecisionSchema: z.ZodEnum<{
+    unknown: "unknown";
+    day: "day";
+    month: "month";
+    year: "year";
+}>;
+/**
+ * A parsed {@link validPrecisionSchema}.
+ *
+ * @stability experimental
+ */
+export type ValidPrecisionLabel = z.infer<typeof validPrecisionSchema>;
+/**
+ * A calendar date, `YYYY-MM-DD`.
+ *
+ * @stability experimental
+ */
+export declare const isoDateSchema: z.ZodString;
+/**
+ * The item kinds a fixture labels.
+ *
+ * @stability experimental
+ */
+export declare const ITEM_LABEL_KINDS: readonly ["commitment", "decision", "claim", "person_fact"];
+/**
+ * One of {@link ITEM_LABEL_KINDS}.
+ *
+ * @stability experimental
+ */
+export type ItemLabelKind = (typeof ITEM_LABEL_KINDS)[number];
+/**
+ * A gold entity row: `key` is local to its fixture, `existingId` names the known entity a resolver must link it to.
+ *
+ * @stability experimental
+ */
+export declare const goldenEntityLabelSchema: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodString;
+    label: z.ZodString;
+    aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    existingId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        source: z.ZodLiteral<"segment">;
+        segmentId: z.ZodString;
+        quote: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"note">;
+        quote: z.ZodString;
+    }, z.core.$strip>], "source">>;
+}, z.core.$strip>;
+/**
+ * A parsed {@link goldenEntityLabelSchema}.
+ *
+ * @stability experimental
+ */
+export type GoldenEntityLabel = z.infer<typeof goldenEntityLabelSchema>;
+/**
+ * A gold edge: `from`/`to` name a label key or a known entity id; temporal bounds per §5.4.
+ *
+ * @stability experimental
+ */
+export declare const goldenRelationLabelSchema: z.ZodObject<{
+    type: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    validFrom: z.ZodNullable<z.ZodString>;
+    validTo: z.ZodNullable<z.ZodString>;
+    precision: z.ZodEnum<{
+        unknown: "unknown";
+        day: "day";
+        month: "month";
+        year: "year";
+    }>;
+    props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        source: z.ZodLiteral<"segment">;
+        segmentId: z.ZodString;
+        quote: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"note">;
+        quote: z.ZodString;
+    }, z.core.$strip>], "source">>;
+}, z.core.$strip>;
+/**
+ * A parsed {@link goldenRelationLabelSchema}.
+ *
+ * @stability experimental
+ */
+export type GoldenRelationLabel = z.infer<typeof goldenRelationLabelSchema>;
+/**
+ * A gold commitment, decision, claim or person fact, with its owner and counterparty columns.
+ *
+ * @stability experimental
+ */
+export declare const goldenItemLabelSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        commitment: "commitment";
+        decision: "decision";
+        claim: "claim";
+        person_fact: "person_fact";
+    }>;
+    subject: z.ZodString;
+    owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    counterparty: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    title: z.ZodString;
+    statement: z.ZodString;
+    status: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        open: "open";
+        done: "done";
+        dropped: "dropped";
+    }>>>;
+    occurredAt: z.ZodNullable<z.ZodString>;
+    dueAt: z.ZodNullable<z.ZodString>;
+    sensitivity: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        business: "business";
+        personal: "personal";
+        sensitive: "sensitive";
+    }>>>;
+    supersedesLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        source: z.ZodLiteral<"segment">;
+        segmentId: z.ZodString;
+        quote: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"note">;
+        quote: z.ZodString;
+    }, z.core.$strip>], "source">>;
+}, z.core.$strip>;
+/**
+ * A parsed {@link goldenItemLabelSchema}.
+ *
+ * @stability experimental
+ */
+export type GoldenItemLabel = z.infer<typeof goldenItemLabelSchema>;
+/**
+ * One synthetic meeting of the golden set: the raw material an extraction run reads
+ * (segments, note, Context, the prior graph) and the hand labels it is scored against.
+ *
+ * @stability experimental
+ */
+export declare const goldenFixtureSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    recordedAt: z.ZodString;
+    contextText: z.ZodNullable<z.ZodString>;
+    hasTranscript: z.ZodBoolean;
+    speakers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        displayName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    segments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        speakerId: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        rev: z.ZodDefault<z.ZodNumber>;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+    note: z.ZodObject<{
+        version: z.ZodDefault<z.ZodNumber>;
+        body: z.ZodString;
+    }, z.core.$strip>;
+    knownEntities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodString;
+        aliases: z.ZodArray<z.ZodString>;
+        props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attendedFixtureIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    knownRelations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        validFrom: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        validTo: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        precision: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            day: "day";
+            month: "month";
+            year: "year";
+        }>>;
+    }, z.core.$strip>>>;
+    labels: z.ZodObject<{
+        entities: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodString;
+            label: z.ZodString;
+            aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            existingId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"segment">;
+                segmentId: z.ZodString;
+                quote: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                source: z.ZodLiteral<"note">;
+                quote: z.ZodString;
+            }, z.core.$strip>], "source">>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            from: z.ZodString;
+            to: z.ZodString;
+            validFrom: z.ZodNullable<z.ZodString>;
+            validTo: z.ZodNullable<z.ZodString>;
+            precision: z.ZodEnum<{
+                unknown: "unknown";
+                day: "day";
+                month: "month";
+                year: "year";
+            }>;
+            props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"segment">;
+                segmentId: z.ZodString;
+                quote: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                source: z.ZodLiteral<"note">;
+                quote: z.ZodString;
+            }, z.core.$strip>], "source">>;
+        }, z.core.$strip>>;
+        items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                commitment: "commitment";
+                decision: "decision";
+                claim: "claim";
+                person_fact: "person_fact";
+            }>;
+            subject: z.ZodString;
+            owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            counterparty: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            title: z.ZodString;
+            statement: z.ZodString;
+            status: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                open: "open";
+                done: "done";
+                dropped: "dropped";
+            }>>>;
+            occurredAt: z.ZodNullable<z.ZodString>;
+            dueAt: z.ZodNullable<z.ZodString>;
+            sensitivity: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                business: "business";
+                personal: "personal";
+                sensitive: "sensitive";
+            }>>>;
+            supersedesLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            evidence: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"segment">;
+                segmentId: z.ZodString;
+                quote: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                source: z.ZodLiteral<"note">;
+                quote: z.ZodString;
+            }, z.core.$strip>], "source">>;
+        }, z.core.$strip>>;
+        negatives: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            quote: z.ZodString;
+            why: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * A parsed golden fixture (defaults applied).
+ *
+ * @stability experimental
+ */
+export type GoldenFixture = z.infer<typeof goldenFixtureSchema>;
+/**
+ * A golden fixture as written on disk (before defaults), the shape an exported skeleton takes.
+ *
+ * @stability experimental
+ */
+export type GoldenFixtureInput = z.input<typeof goldenFixtureSchema>;
+/**
+ * `m03#claim-1`: the address an item is known by across the set.
+ *
+ * @param fixtureId - the fixture the item is labelled in.
+ * @param kind - the item's kind.
+ * @param indexWithinKind - its 0-based position among that fixture's items of that kind.
+ * @returns the address.
+ * @stability experimental
+ */
+export declare function itemAddress(fixtureId: string, kind: ItemLabelKind, indexWithinKind: number): string;
+/**
+ * Every item in a fixture keyed by its cross-fixture address.
+ *
+ * @param fixture - the fixture.
+ * @returns the items by {@link itemAddress}.
+ * @stability experimental
+ */
+export declare function itemsByAddress(fixture: GoldenFixture): Map<string, GoldenItemLabel>;

package/dist/fixtures/fixture-schema.js

@@ -0,0 +1,199 @@
+"use strict";
+// =============================================================================
+// The knowledge-graph golden set: fixture schema (issue #362, epic #346)
+// =============================================================================
+//
+// One JSON file per synthetic meeting under
+// `packages/kvox-eval/fixtures/kg-golden/meetings/mNN-<slug>.json`. The file carries
+// the raw material an extraction run reads (segments, the note body, Context,
+// the prior graph state as `knownEntities`) AND the hand labels a run is
+// scored against (`labels`). See the README beside the fixtures for the
+// authoring rules; `docs/specs/ontology.md` §6 for why the set exists.
+//
+// This file lives in `@marinoscar/kvox-eval` (issue #580), never in an app's
+// `src/`: no production build of the API or the web app compiles it. The app
+// reaches it only from its `scripts/` and its specs.
+//
+// Reference conventions used by the labels:
+//   - an entity label's `key` is local to its fixture ("sarah", "meeting");
+//   - a relation's `from`/`to` and an item's `subject`/`owner`/`counterparty`
+//     name either such a key or a `knownEntities` id ("g-person-sarah-chen");
+//   - an item is addressed from another fixture as `<fixtureId>#<kind>-<n>`,
+//     `n` being its 1-based position among that fixture's items of that kind
+//     ("m03#claim-1") — that is what `supersedesLabel` holds.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goldenFixtureSchema = exports.goldenItemLabelSchema = exports.goldenRelationLabelSchema = exports.goldenEntityLabelSchema = exports.ITEM_LABEL_KINDS = exports.isoDateSchema = exports.validPrecisionSchema = exports.evidenceLabelSchema = void 0;
+exports.itemAddress = itemAddress;
+exports.itemsByAddress = itemsByAddress;
+const zod_1 = require("zod");
+/**
+ * One citation of a gold label: a transcript segment and a verbatim quote from it,
+ * or a verbatim quote from the note body.
+ *
+ * @stability experimental
+ */
+exports.evidenceLabelSchema = zod_1.z.discriminatedUnion('source', [
+    zod_1.z.object({ source: zod_1.z.literal('segment'), segmentId: zod_1.z.string(), quote: zod_1.z.string().min(1).max(400) }),
+    zod_1.z.object({ source: zod_1.z.literal('note'), quote: zod_1.z.string().min(1).max(400) }),
+]);
+/**
+ * The precision of a temporal label (docs/specs/ontology.md §5.4): `unknown` means both bounds are `null`.
+ *
+ * @stability experimental
+ */
+exports.validPrecisionSchema = zod_1.z.enum(['day', 'month', 'year', 'unknown']);
+/**
+ * A calendar date, `YYYY-MM-DD`.
+ *
+ * @stability experimental
+ */
+exports.isoDateSchema = zod_1.z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+/**
+ * The item kinds a fixture labels.
+ *
+ * @stability experimental
+ */
+exports.ITEM_LABEL_KINDS = ['commitment', 'decision', 'claim', 'person_fact'];
+const propsSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({});
+/**
+ * A gold entity row: `key` is local to its fixture, `existingId` names the known entity a resolver must link it to.
+ *
+ * @stability experimental
+ */
+exports.goldenEntityLabelSchema = zod_1.z.object({
+    key: zod_1.z.string().min(1),
+    type: zod_1.z.string(),
+    label: zod_1.z.string().min(1),
+    aliases: zod_1.z.array(zod_1.z.string()).default([]),
+    /** When set, a resolver must link this mention to that `knownEntities` id. */
+    existingId: zod_1.z.string().nullable().default(null),
+    props: propsSchema,
+    evidence: zod_1.z.array(exports.evidenceLabelSchema).min(1),
+});
+/**
+ * A gold edge: `from`/`to` name a label key or a known entity id; temporal bounds per §5.4.
+ *
+ * @stability experimental
+ */
+exports.goldenRelationLabelSchema = zod_1.z.object({
+    type: zod_1.z.string(),
+    from: zod_1.z.string(),
+    to: zod_1.z.string(),
+    validFrom: exports.isoDateSchema.nullable(),
+    validTo: exports.isoDateSchema.nullable(),
+    precision: exports.validPrecisionSchema,
+    props: propsSchema,
+    evidence: zod_1.z.array(exports.evidenceLabelSchema).min(1),
+});
+/**
+ * A gold commitment, decision, claim or person fact, with its owner and counterparty columns.
+ *
+ * @stability experimental
+ */
+exports.goldenItemLabelSchema = zod_1.z.object({
+    kind: zod_1.z.enum(exports.ITEM_LABEL_KINDS),
+    subject: zod_1.z.string(),
+    owner: zod_1.z.string().nullable().default(null),
+    counterparty: zod_1.z.string().nullable().default(null),
+    title: zod_1.z.string().min(1),
+    statement: zod_1.z.string().min(1),
+    status: zod_1.z.enum(['open', 'done', 'dropped']).nullable().default(null),
+    occurredAt: exports.isoDateSchema.nullable(),
+    dueAt: exports.isoDateSchema.nullable(),
+    sensitivity: zod_1.z.enum(['business', 'personal', 'sensitive']).nullable().default(null),
+    /** `<fixtureId>#<kind>-<n>`: the earlier item this one replaces. */
+    supersedesLabel: zod_1.z.string().nullable().default(null),
+    evidence: zod_1.z.array(exports.evidenceLabelSchema).min(1),
+});
+/**
+ * One synthetic meeting of the golden set: the raw material an extraction run reads
+ * (segments, note, Context, the prior graph) and the hand labels it is scored against.
+ *
+ * @stability experimental
+ */
+exports.goldenFixtureSchema = zod_1.z.object({
+    id: zod_1.z.string().regex(/^m\d{2,3}$/),
+    title: zod_1.z.string().min(1),
+    tags: zod_1.z.array(zod_1.z.string()),
+    /** The meeting date — the anchor every relative date resolves against (§5.4). */
+    recordedAt: zod_1.z.string().datetime(),
+    /** The note's Context field, as the user typed it. */
+    contextText: zod_1.z.string().nullable(),
+    /** false = a note-only meeting: no speakers, no segments, note evidence only. */
+    hasTranscript: zod_1.z.boolean(),
+    speakers: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), label: zod_1.z.string(), displayName: zod_1.z.string().nullable() })),
+    segments: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        speakerId: zod_1.z.string(),
+        startMs: zod_1.z.number().int(),
+        endMs: zod_1.z.number().int(),
+        rev: zod_1.z.number().int().default(1),
+        text: zod_1.z.string().min(1),
+    })),
+    note: zod_1.z.object({ version: zod_1.z.number().int().default(1), body: zod_1.z.string().min(1) }),
+    /** The graph as it stood before this meeting: what resolution may link to. */
+    knownEntities: zod_1.z
+        .array(zod_1.z.object({
+        id: zod_1.z.string(),
+        type: zod_1.z.string(),
+        label: zod_1.z.string(),
+        aliases: zod_1.z.array(zod_1.z.string()),
+        props: propsSchema,
+        attendedFixtureIds: zod_1.z.array(zod_1.z.string()).default([]),
+    }))
+        .default([]),
+    /**
+     * #365: the prior graph's accepted temporal/other edges between known
+     * entities, so the in-memory `work-item-dedup`/`temporal-closing` pass has
+     * something to find `known` and to close. Optional; absent = none.
+     */
+    knownRelations: zod_1.z
+        .array(zod_1.z.object({
+        id: zod_1.z.string(),
+        type: zod_1.z.string(),
+        from: zod_1.z.string(),
+        to: zod_1.z.string(),
+        props: propsSchema,
+        validFrom: exports.isoDateSchema.nullable().default(null),
+        validTo: exports.isoDateSchema.nullable().default(null),
+        precision: exports.validPrecisionSchema.default('unknown'),
+    }))
+        .default([]),
+    labels: zod_1.z.object({
+        entities: zod_1.z.array(exports.goldenEntityLabelSchema),
+        relations: zod_1.z.array(exports.goldenRelationLabelSchema),
+        items: zod_1.z.array(exports.goldenItemLabelSchema),
+        /** §5.1 negative examples: text a correct extractor must NOT turn into a row. */
+        negatives: zod_1.z.array(zod_1.z.object({ quote: zod_1.z.string(), why: zod_1.z.string() })).default([]),
+    }),
+});
+/**
+ * `m03#claim-1`: the address an item is known by across the set.
+ *
+ * @param fixtureId - the fixture the item is labelled in.
+ * @param kind - the item's kind.
+ * @param indexWithinKind - its 0-based position among that fixture's items of that kind.
+ * @returns the address.
+ * @stability experimental
+ */
+function itemAddress(fixtureId, kind, indexWithinKind) {
+    return `${fixtureId}#${kind}-${indexWithinKind + 1}`;
+}
+/**
+ * Every item in a fixture keyed by its cross-fixture address.
+ *
+ * @param fixture - the fixture.
+ * @returns the items by {@link itemAddress}.
+ * @stability experimental
+ */
+function itemsByAddress(fixture) {
+    const counters = new Map();
+    const out = new Map();
+    for (const item of fixture.labels.items) {
+        const n = counters.get(item.kind) ?? 0;
+        counters.set(item.kind, n + 1);
+        out.set(itemAddress(fixture.id, item.kind, n), item);
+    }
+    return out;
+}

package/dist/fixtures/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@marinoscar/kvox-eval/fixtures`: the synthetic golden set and its contract.
+ *
+ * @remarks
+ * The committed meetings (`fixtures/kg-golden/meetings/`) and the Ask question
+ * file beside them, the schema every fixture is validated with, and the loaders.
+ * Every meeting is invented: no real recording, transcript, note, name, company,
+ * email address or phone number belongs in the set (`fixtures/kg-golden/README.md`).
+ *
+ * @packageDocumentation
+ */
+export { evidenceLabelSchema, goldenEntityLabelSchema, goldenFixtureSchema, goldenItemLabelSchema, goldenRelationLabelSchema, isoDateSchema, ITEM_LABEL_KINDS, itemAddress, itemsByAddress, validPrecisionSchema, } from './fixture-schema.js';
+export type { EvidenceLabel, GoldenEntityLabel, GoldenFixture, GoldenFixtureInput, GoldenItemLabel, GoldenRelationLabel, ItemLabelKind, ValidPrecisionLabel, } from './fixture-schema.js';
+export { fixtureDomains, PERSONAL_FIXTURE_TAG } from './domains.js';
+export { GOLDEN_MEETINGS_DIR, GOLDEN_SET_DIR, KgEvalLoadError, listFixtureFiles, loadFixtureFile, loadGoldenMeetings, loadGoldenSet, selectFixtures, } from './load.js';
+export { ASK_QUESTIONS_PATH, loadGoldenAskQuestions } from './questions.js';

package/dist/fixtures/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGoldenAskQuestions = exports.ASK_QUESTIONS_PATH = exports.selectFixtures = exports.loadGoldenSet = exports.loadGoldenMeetings = exports.loadFixtureFile = exports.listFixtureFiles = exports.KgEvalLoadError = exports.GOLDEN_SET_DIR = exports.GOLDEN_MEETINGS_DIR = exports.PERSONAL_FIXTURE_TAG = exports.fixtureDomains = exports.validPrecisionSchema = exports.itemsByAddress = exports.itemAddress = exports.ITEM_LABEL_KINDS = exports.isoDateSchema = exports.goldenRelationLabelSchema = exports.goldenItemLabelSchema = exports.goldenFixtureSchema = exports.goldenEntityLabelSchema = exports.evidenceLabelSchema = void 0;
+/**
+ * `@marinoscar/kvox-eval/fixtures`: the synthetic golden set and its contract.
+ *
+ * @remarks
+ * The committed meetings (`fixtures/kg-golden/meetings/`) and the Ask question
+ * file beside them, the schema every fixture is validated with, and the loaders.
+ * Every meeting is invented: no real recording, transcript, note, name, company,
+ * email address or phone number belongs in the set (`fixtures/kg-golden/README.md`).
+ *
+ * @packageDocumentation
+ */
+var fixture_schema_js_1 = require("./fixture-schema.js");
+Object.defineProperty(exports, "evidenceLabelSchema", { enumerable: true, get: function () { return fixture_schema_js_1.evidenceLabelSchema; } });
+Object.defineProperty(exports, "goldenEntityLabelSchema", { enumerable: true, get: function () { return fixture_schema_js_1.goldenEntityLabelSchema; } });
+Object.defineProperty(exports, "goldenFixtureSchema", { enumerable: true, get: function () { return fixture_schema_js_1.goldenFixtureSchema; } });
+Object.defineProperty(exports, "goldenItemLabelSchema", { enumerable: true, get: function () { return fixture_schema_js_1.goldenItemLabelSchema; } });
+Object.defineProperty(exports, "goldenRelationLabelSchema", { enumerable: true, get: function () { return fixture_schema_js_1.goldenRelationLabelSchema; } });
+Object.defineProperty(exports, "isoDateSchema", { enumerable: true, get: function () { return fixture_schema_js_1.isoDateSchema; } });
+Object.defineProperty(exports, "ITEM_LABEL_KINDS", { enumerable: true, get: function () { return fixture_schema_js_1.ITEM_LABEL_KINDS; } });
+Object.defineProperty(exports, "itemAddress", { enumerable: true, get: function () { return fixture_schema_js_1.itemAddress; } });
+Object.defineProperty(exports, "itemsByAddress", { enumerable: true, get: function () { return fixture_schema_js_1.itemsByAddress; } });
+Object.defineProperty(exports, "validPrecisionSchema", { enumerable: true, get: function () { return fixture_schema_js_1.validPrecisionSchema; } });
+var domains_js_1 = require("./domains.js");
+Object.defineProperty(exports, "fixtureDomains", { enumerable: true, get: function () { return domains_js_1.fixtureDomains; } });
+Object.defineProperty(exports, "PERSONAL_FIXTURE_TAG", { enumerable: true, get: function () { return domains_js_1.PERSONAL_FIXTURE_TAG; } });
+var load_js_1 = require("./load.js");
+Object.defineProperty(exports, "GOLDEN_MEETINGS_DIR", { enumerable: true, get: function () { return load_js_1.GOLDEN_MEETINGS_DIR; } });
+Object.defineProperty(exports, "GOLDEN_SET_DIR", { enumerable: true, get: function () { return load_js_1.GOLDEN_SET_DIR; } });
+Object.defineProperty(exports, "KgEvalLoadError", { enumerable: true, get: function () { return load_js_1.KgEvalLoadError; } });
+Object.defineProperty(exports, "listFixtureFiles", { enumerable: true, get: function () { return load_js_1.listFixtureFiles; } });
+Object.defineProperty(exports, "loadFixtureFile", { enumerable: true, get: function () { return load_js_1.loadFixtureFile; } });
+Object.defineProperty(exports, "loadGoldenMeetings", { enumerable: true, get: function () { return load_js_1.loadGoldenMeetings; } });
+Object.defineProperty(exports, "loadGoldenSet", { enumerable: true, get: function () { return load_js_1.loadGoldenSet; } });
+Object.defineProperty(exports, "selectFixtures", { enumerable: true, get: function () { return load_js_1.selectFixtures; } });
+var questions_js_1 = require("./questions.js");
+Object.defineProperty(exports, "ASK_QUESTIONS_PATH", { enumerable: true, get: function () { return questions_js_1.ASK_QUESTIONS_PATH; } });
+Object.defineProperty(exports, "loadGoldenAskQuestions", { enumerable: true, get: function () { return questions_js_1.loadGoldenAskQuestions; } });

package/dist/fixtures/load.d.ts

@@ -0,0 +1,73 @@
+import { type GoldenFixture } from './fixture-schema.js';
+/**
+ * The committed, synthetic golden set's directory (`fixtures/kg-golden/` of the package).
+ *
+ * @stability experimental
+ */
+export declare const GOLDEN_SET_DIR: string;
+/**
+ * The committed, synthetic meetings (`fixtures/kg-golden/meetings/`).
+ *
+ * @stability experimental
+ */
+export declare const GOLDEN_MEETINGS_DIR: string;
+/**
+ * A golden set (or a selection of it) that cannot be loaded: a file that is not
+ * JSON or does not match its schema, a duplicate id, an unknown id. The CLIs map
+ * it to exit code 2.
+ *
+ * @stability experimental
+ */
+export declare class KgEvalLoadError extends Error {
+}
+/**
+ * Every `*.json` file of a directory, sorted by name.
+ *
+ * @param dir - the directory.
+ * @returns absolute paths.
+ * @stability experimental
+ */
+export declare function listFixtureFiles(dir: string): string[];
+/**
+ * One fixture file, parsed and validated.
+ *
+ * @param file - the file.
+ * @returns the fixture.
+ * @throws {@link KgEvalLoadError} when it is not JSON or does not match `goldenFixtureSchema`.
+ * @stability experimental
+ */
+export declare function loadFixtureFile(file: string): GoldenFixture;
+/**
+ * Every fixture of a directory, sorted by id (numerically: m2 before m10).
+ *
+ * @param dir - the directory; default the committed {@link GOLDEN_MEETINGS_DIR}.
+ * @returns the fixtures.
+ * @throws {@link KgEvalLoadError} on a malformed file or a duplicate id.
+ * @stability experimental
+ */
+export declare function loadGoldenSet(dir?: string): GoldenFixture[];
+/**
+ * `--only m01,m07` / `--tag promotion`: both narrow; neither given keeps all.
+ *
+ * @param fixtures - the loaded set.
+ * @param only - fixture ids to keep, or `null`.
+ * @param tag - a tag every kept fixture carries, or `null`.
+ * @returns the selection, in set order.
+ * @throws {@link KgEvalLoadError} when `only` names an id the set does not have.
+ * @stability experimental
+ */
+export declare function selectFixtures(fixtures: GoldenFixture[], only: string[] | null, tag: string | null): GoldenFixture[];
+/**
+ * The committed golden meetings, optionally narrowed to some ids.
+ *
+ * @example
+ * ```ts
+ * const [m01, m07] = loadGoldenMeetings(['m01', 'm07']);
+ * ```
+ *
+ * @param ids - fixture ids to keep (in set order); omitted or empty keeps all.
+ * @returns the fixtures.
+ * @throws {@link KgEvalLoadError} on a malformed file or an unknown id.
+ * @stability experimental
+ */
+export declare function loadGoldenMeetings(ids?: readonly string[]): GoldenFixture[];