@sanity/ailf 2.8.0 → 2.9.0

package/dist/_vendor/ailf-core/index.d.ts

@@ -20,4 +20,5 @@ export { defineConfig, defineFeatures, defineModeBase, defineModels, definePrici
 export type { PricingEntry, PromptEntry, SourceEntry, } from "./config-helpers.js";
 export { env } from "./env-helper.js";
 export { NoOpArtifactCollector } from "./artifact-capture/noop-collector.js";
-export { NoOpArtifactWriter } from "./ports/artifact-writer.js";
+export { NoOpArtifactWriter, NotImplementedError, } from "./ports/artifact-writer.js";
+export { assoc, type AssocContext } from "./artifact-capture/association.js";

package/dist/_vendor/ailf-core/index.js

@@ -22,4 +22,5 @@ export * from "./artifact-registry.js";
 export { defineConfig, defineFeatures, defineModeBase, defineModels, definePricingTable, definePreset, definePrompts, defineRubrics, defineSchedules, defineSinks, defineSources, defineTask, defineThresholds, } from "./config-helpers.js";
 export { env } from "./env-helper.js";
 export { NoOpArtifactCollector } from "./artifact-capture/noop-collector.js";
-export { NoOpArtifactWriter } from "./ports/artifact-writer.js";
+export { NoOpArtifactWriter, NotImplementedError, } from "./ports/artifact-writer.js";
+export { assoc } from "./artifact-capture/association.js";

package/dist/_vendor/ailf-core/ports/artifact-writer.d.ts

@@ -1,26 +1,35 @@
 /**
  * Port: ArtifactWriter — writes run artifacts + the run manifest to external storage.
  *
- * Replaces the older `ArtifactUploader` port from D0030. Differences:
- *   - Paths anchor to `RunId` (not `ReportId`) via the registry's `objectPath`.
- *   - Supports both `"bulk"` and `"per-entry"` layouts.
- *   - A dedicated `writeManifest()` method for the run manifest at
- *     `runs/{runId}/manifest.json`.
+ * D0033 / W0049 unifies the writer API around a single caller-facing method:
  *
- * Producer steps call writer methods directly with the artifact type from
- * `ARTIFACT_REGISTRY`. Path construction, schema validation, and entry-key
- * sanitization live in the registry, not the call site.
+ *   - `emit(type, association, payload)` — the canonical write. Dispatch on
+ *     `descriptor.layout` is internal; callers never pick a shape.
+ *   - `appendNdjson(type, association, rows)` — streaming-append variant used
+ *     only by the `traces` artifact. Semantics differ from `emit` (repeated
+ *     append vs. single-shot write) so it gets its own method rather than an
+ *     overload.
+ *   - `writeManifest(runId, manifest)` — writes the run manifest at
+ *     `runs/{runId}/manifest.json`.
+ *   - `writeBulk` / `writePerEntry` — @deprecated legacy surface retained for
+ *     producer code that has not migrated to `emit`. Removal scheduled for
+ *     W0052 (see `docs/decisions/D0033-unified-run-anchored-artifact-capture.md`).
  *
  * @see docs/decisions/D0032-run-anchored-artifact-store.md
+ * @see docs/decisions/D0033-unified-run-anchored-artifact-capture.md
  * @see packages/core/src/artifact-registry.ts
  */
 import type { ArtifactType } from "../artifact-registry.js";
-import type { RunId } from "../types/branded-ids.js";
+import type { AssociationValues, RunId } from "../types/branded-ids.js";
 import type { ArtifactRef, RunManifest } from "../types/index.js";
 /**
  * An entry in a per-entry upload. The `key` is the wire-format identifier
  * (e.g. `{taskId}::{modelId}` for testOutputs); the writer sanitizes it into
- * the filename using the registry's `parseEntryKey`.
+ * the filename using the registry's `parseEntryKey` or direct path building.
+ *
+ * @deprecated Use `ArtifactWriter.emit()` with `AssociationValues` instead.
+ * This type is retained for producers still on the legacy
+ * `writeBulk`/`writePerEntry` path; removal scheduled for W0052.
  */
 export interface ArtifactEntry<TData = unknown> {
     key: string;
@@ -28,29 +37,59 @@ export interface ArtifactEntry<TData = unknown> {
 }
 export interface ArtifactWriter {
     /**
-     * Write a bulk artifact — one JSON object per (runId, type).
+     * Write a single artifact. The descriptor's `layout` determines whether
+     * this produces a bulk object (`runs/{runId}/{slug}.{ext}`) or a per-entry
+     * object (`runs/{runId}/{slug}/{entryKey}.{ext}`).
      *
-     * @returns An `ArtifactRef` pointing at `runs/{runId}/{slug}.json`, or
-     *          `null` when upload is skipped or fails (P5: non-blocking).
+     * For per-entry descriptors, `association` must carry the axis values the
+     * descriptor's `formatEntryKey` consumes. For bulk descriptors, only `run`
+     * is required.
+     *
+     * @returns `ArtifactRef` on success, or `null` when upload is skipped or
+     *          fails (P5: non-blocking).
      */
-    writeBulk(type: ArtifactType, runId: RunId, data: unknown): Promise<ArtifactRef | null>;
+    emit<T extends ArtifactType>(type: T, association: AssociationValues, payload: unknown): Promise<ArtifactRef | null>;
     /**
-     * Write a per-entry artifact — one JSON object per entry, all under
-     * `runs/{runId}/{slug}/`.
+     * Append NDJSON rows to a per-entry artifact. Used only by `traces`, whose
+     * per-entry payload is itself unbounded during production. The writer
+     * buffers rows keyed on (type, entryKey) and flushes to numbered part
+     * objects; the backend composes parts into the final object at trial
+     * completion.
      *
-     * The returned `ArtifactRef.entries` inlines the catalog so consumers
-     * can render drill-down state without a second listing call.
+     * @throws NotImplementedError on writers that don't support streaming
+     *         appends (e.g. the API-gateway-backed writer; see W0052).
      */
-    writePerEntry(type: ArtifactType, runId: RunId, entries: readonly ArtifactEntry[]): Promise<ArtifactRef | null>;
+    appendNdjson<T extends ArtifactType>(type: T, association: AssociationValues, rows: readonly unknown[]): Promise<ArtifactRef | null>;
     /**
      * Write the run manifest to `runs/{runId}/manifest.json`. Single-writer
      * per run; subsequent publishes may rewrite to append `reportIds[]`.
      */
     writeManifest(runId: RunId, manifest: RunManifest): Promise<ArtifactRef | null>;
+    /**
+     * @deprecated Use `emit()` with `AssociationValues` instead. Retained for
+     * producers still on the legacy path; removal scheduled for W0052.
+     */
+    writeBulk(type: ArtifactType, runId: RunId, data: unknown): Promise<ArtifactRef | null>;
+    /**
+     * @deprecated Use `emit()` per entry instead. Retained for producers still
+     * on the legacy path; removal scheduled for W0052.
+     */
+    writePerEntry(type: ArtifactType, runId: RunId, entries: readonly ArtifactEntry[]): Promise<ArtifactRef | null>;
+}
+/**
+ * Thrown by writers that can't satisfy a method — e.g. an
+ * `ApiGatewayArtifactWriter` cannot implement `appendNdjson` until the batch
+ * signing endpoint (W0052) lands. Callers should treat this as an explicit
+ * failure rather than a silent no-op so the gap surfaces in logs.
+ */
+export declare class NotImplementedError extends Error {
+    constructor(message: string);
 }
 /** No-op writer — every method returns null. Used when no storage is configured. */
 export declare class NoOpArtifactWriter implements ArtifactWriter {
+    emit(): Promise<null>;
+    appendNdjson(): Promise<null>;
+    writeManifest(): Promise<null>;
     writeBulk(): Promise<null>;
     writePerEntry(): Promise<null>;
-    writeManifest(): Promise<null>;
 }

package/dist/_vendor/ailf-core/ports/artifact-writer.js

@@ -1,28 +1,51 @@
 /**
  * Port: ArtifactWriter — writes run artifacts + the run manifest to external storage.
  *
- * Replaces the older `ArtifactUploader` port from D0030. Differences:
- *   - Paths anchor to `RunId` (not `ReportId`) via the registry's `objectPath`.
- *   - Supports both `"bulk"` and `"per-entry"` layouts.
- *   - A dedicated `writeManifest()` method for the run manifest at
- *     `runs/{runId}/manifest.json`.
+ * D0033 / W0049 unifies the writer API around a single caller-facing method:
  *
- * Producer steps call writer methods directly with the artifact type from
- * `ARTIFACT_REGISTRY`. Path construction, schema validation, and entry-key
- * sanitization live in the registry, not the call site.
+ *   - `emit(type, association, payload)` — the canonical write. Dispatch on
+ *     `descriptor.layout` is internal; callers never pick a shape.
+ *   - `appendNdjson(type, association, rows)` — streaming-append variant used
+ *     only by the `traces` artifact. Semantics differ from `emit` (repeated
+ *     append vs. single-shot write) so it gets its own method rather than an
+ *     overload.
+ *   - `writeManifest(runId, manifest)` — writes the run manifest at
+ *     `runs/{runId}/manifest.json`.
+ *   - `writeBulk` / `writePerEntry` — @deprecated legacy surface retained for
+ *     producer code that has not migrated to `emit`. Removal scheduled for
+ *     W0052 (see `docs/decisions/D0033-unified-run-anchored-artifact-capture.md`).
  *
  * @see docs/decisions/D0032-run-anchored-artifact-store.md
+ * @see docs/decisions/D0033-unified-run-anchored-artifact-capture.md
  * @see packages/core/src/artifact-registry.ts
  */
+/**
+ * Thrown by writers that can't satisfy a method — e.g. an
+ * `ApiGatewayArtifactWriter` cannot implement `appendNdjson` until the batch
+ * signing endpoint (W0052) lands. Callers should treat this as an explicit
+ * failure rather than a silent no-op so the gap surfaces in logs.
+ */
+export class NotImplementedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NotImplementedError";
+    }
+}
 /** No-op writer — every method returns null. Used when no storage is configured. */
 export class NoOpArtifactWriter {
-    async writeBulk() {
+    async emit() {
         return null;
     }
-    async writePerEntry() {
+    async appendNdjson() {
         return null;
     }
     async writeManifest() {
         return null;
     }
+    async writeBulk() {
+        return null;
+    }
+    async writePerEntry() {
+        return null;
+    }
 }

package/dist/_vendor/ailf-core/ports/context.d.ts

@@ -161,6 +161,20 @@ export interface ResolvedConfig {
     captureCompress?: boolean;
     /** Whether to include mode-specific extra artifacts (default: true) */
     captureExtras?: boolean;
+    /**
+     * D0033 / W0049 — the unified artifact surface. Wired into the writer in
+     * W0050; consumed by the writer factory to decide whether to attach a
+     * writer at all, where it writes to, and what to skip. These fields are
+     * additive and do not replace the legacy `capture*` fields until W0052.
+     */
+    /** Disables all artifact writers — `--no-artifacts`. */
+    artifactsDisabled?: boolean;
+    /** Root directory for local artifact output — `--artifacts-dir`. */
+    artifactsDir?: string;
+    /** Run writers in dry-run mode — `--artifacts-dry-run`. */
+    artifactsDryRun?: boolean;
+    /** Comma-separated artifact types to skip — `--capture-exclude`. */
+    artifactsExclude?: readonly string[];
     /** GCS bucket for capture upload (enables GCS decorator when set) */
     captureGcsBucket?: string;
     /** GCS object prefix for capture uploads (default: "captures/") */
@@ -198,8 +212,13 @@ export interface ResolvedConfig {
  * Created per-test by createTestContext().
  */
 export interface AppContext {
-    /** Artifact writer — writes run artifacts + manifest to GCS (D0032) */
-    readonly artifactWriter?: ArtifactWriter;
+    /**
+     * Artifact writer — writes run artifacts + manifest to local fs (D0033
+     * M4: always on) and optionally to GCS (D0032, layered via
+     * FanoutArtifactWriter). Required post-W0050 — the composition root
+     * always provides a writer (NoOpArtifactWriter when `--no-artifacts`).
+     */
+    readonly artifactWriter: ArtifactWriter;
     /** Evaluation caching (filesystem + optional Content Lake fallback) */
     readonly cache?: CacheStore;
     /** Artifact capture collector (no-op when --capture is not set) */

package/dist/_vendor/ailf-core/schemas/pipeline.d.ts

@@ -67,10 +67,10 @@ export declare const FeatureSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     priority: z.ZodEnum<{
-        critical: "critical";
-        high: "high";
-        medium: "medium";
         low: "low";
+        medium: "medium";
+        high: "high";
+        critical: "critical";
     }>;
     sections: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
@@ -91,10 +91,10 @@ export declare const FeatureRegistrySchema: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         priority: z.ZodEnum<{
-            critical: "critical";
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
+            critical: "critical";
         }>;
         sections: z.ZodArray<z.ZodString>;
         status: z.ZodEnum<{

package/dist/_vendor/ailf-core/services/index.d.ts

@@ -11,3 +11,4 @@ export { classifyRubric, detectFeatureArea, extractDimensions, extractUrlMetadat
 export { formatComparisonMarkdown, formatComparisonTable, } from "./comparison-formatters.js";
 export { aggregateAreas, aggregateDimensions, computeEnsembleScore, computeTaskScore, normalizeScore, type AggregationStrategy, type AreaScore, type AssertionScore, type DimensionScore, type EnsembleGradingConfig, type GraderTransitionConfig, type TaskScore, type TaskScoreOptions, } from "./scoring-engine.js";
 export { extractModelName, extractProvider, mergeConfig, modelMatchesMode, resolveModelVariants, } from "./config-helpers.js";
+export { buildSlimReportSummary } from "./slim-report-summary.js";

package/dist/_vendor/ailf-core/services/index.js

@@ -11,3 +11,4 @@ export { classifyRubric, detectFeatureArea, extractDimensions, extractUrlMetadat
 export { formatComparisonMarkdown, formatComparisonTable, } from "./comparison-formatters.js";
 export { aggregateAreas, aggregateDimensions, computeEnsembleScore, computeTaskScore, normalizeScore, } from "./scoring-engine.js";
 export { extractModelName, extractProvider, mergeConfig, modelMatchesMode, resolveModelVariants, } from "./config-helpers.js";
+export { buildSlimReportSummary } from "./slim-report-summary.js";

package/dist/_vendor/ailf-core/services/slim-report-summary.d.ts

@@ -0,0 +1,31 @@
+/**
+ * slim-report-summary.ts
+ *
+ * Pure transformer: a full `ScoreSummary` (the shape of `score-summary.json`)
+ * into the slim `ReportSummary` that Phase C of D0033 publishes on the
+ * Report Content-Lake document. Inlined prose and long arrays are replaced
+ * with `id` references to external artifacts (graderJudgments, failureModes,
+ * gapReport, traces).
+ *
+ * **The `id` principle**: every slim reference carries the manifest entry
+ * key of the external artifact it points at, produced by the descriptor's
+ * own `formatEntryKey(axes)`. Studio looks the id up in `Report.artifactManifest`
+ * to get the preview, and hydrates the full payload on drill-down.
+ *
+ * @see docs/decisions/D0033-unified-run-anchored-artifact-capture.md (§ M7)
+ * @see docs/work-items/W0051-report-slim-down-manifest-preview-hooks.json
+ */
+import type { ReportSummary, ScoreSummary } from "../types/index.js";
+/**
+ * Transform a full pipeline `ScoreSummary` into its slim Report counterpart.
+ *
+ * Each of the four heavy fields is reshaped independently; everything else
+ * flows through untouched via structural spread. Pure function — the input
+ * summary is not mutated.
+ *
+ * @param mode The evaluation mode (used to populate the `mode` axis on slim
+ *             judgment / failure-mode ids). `score-summary.json` carries
+ *             the mode in `evaluationMode` but the publisher supplies it
+ *             explicitly to keep the helper independent of that field.
+ */
+export declare function buildSlimReportSummary(summary: ScoreSummary, mode: string): ReportSummary;

package/dist/_vendor/ailf-core/services/slim-report-summary.js

@@ -0,0 +1,217 @@
+/**
+ * slim-report-summary.ts
+ *
+ * Pure transformer: a full `ScoreSummary` (the shape of `score-summary.json`)
+ * into the slim `ReportSummary` that Phase C of D0033 publishes on the
+ * Report Content-Lake document. Inlined prose and long arrays are replaced
+ * with `id` references to external artifacts (graderJudgments, failureModes,
+ * gapReport, traces).
+ *
+ * **The `id` principle**: every slim reference carries the manifest entry
+ * key of the external artifact it points at, produced by the descriptor's
+ * own `formatEntryKey(axes)`. Studio looks the id up in `Report.artifactManifest`
+ * to get the preview, and hydrates the full payload on drill-down.
+ *
+ * @see docs/decisions/D0033-unified-run-anchored-artifact-capture.md (§ M7)
+ * @see docs/work-items/W0051-report-slim-down-manifest-preview-hooks.json
+ */
+import { ARTIFACT_REGISTRY } from "../artifact-registry.js";
+/**
+ * Transform a full pipeline `ScoreSummary` into its slim Report counterpart.
+ *
+ * Each of the four heavy fields is reshaped independently; everything else
+ * flows through untouched via structural spread. Pure function — the input
+ * summary is not mutated.
+ *
+ * @param mode The evaluation mode (used to populate the `mode` axis on slim
+ *             judgment / failure-mode ids). `score-summary.json` carries
+ *             the mode in `evaluationMode` but the publisher supplies it
+ *             explicitly to keep the helper independent of that field.
+ */
+export function buildSlimReportSummary(summary, mode) {
+    const { agentBehavior: fullAgentBehavior, failureModes: fullFailureModes, lowScoringJudgments: fullJudgments, recommendations: fullRecommendations, ...rest } = summary;
+    return {
+        ...rest,
+        ...(fullJudgments
+            ? { lowScoringJudgments: slimJudgments(fullJudgments, mode) }
+            : {}),
+        ...(fullFailureModes
+            ? { failureModes: slimFailureModes(fullFailureModes, mode) }
+            : {}),
+        ...(fullRecommendations
+            ? { recommendations: slimRecommendations(fullRecommendations) }
+            : {}),
+        ...(fullAgentBehavior
+            ? { agentBehavior: slimAgentBehavior(fullAgentBehavior) }
+            : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Judgments — axes {mode, task, model, grader}
+// ---------------------------------------------------------------------------
+/**
+ * Variant-suffix stripper. Judgments' `taskId` today carries `(gold)` /
+ * `(baseline)` suffixes that encode the pipeline mode. We strip the suffix
+ * to build the canonical `task` axis value and use the caller-supplied
+ * `mode` for the `mode` axis — matching how `formatEntryKey` is computed
+ * at producer emit time.
+ */
+function splitTaskVariant(taskId) {
+    const match = /\s*\((gold|baseline)\)\s*$/i.exec(taskId);
+    if (!match)
+        return { task: taskId, variant: null };
+    return {
+        task: taskId.slice(0, match.index).trim(),
+        variant: match[1].toLowerCase(),
+    };
+}
+function slimJudgments(full, defaultMode) {
+    const descriptor = ARTIFACT_REGISTRY.graderJudgments;
+    const formatKey = descriptor.formatEntryKey;
+    if (!formatKey) {
+        throw new Error("slimJudgments: graderJudgments descriptor is missing formatEntryKey");
+    }
+    return full.map((j) => {
+        const { task, variant } = splitTaskVariant(j.taskId);
+        // The judgment's task variant overrides the caller-supplied mode when
+        // present — a single summary run may carry judgments from both the
+        // gold and baseline halves of a literacy run.
+        const mode = variant ?? defaultMode;
+        const graderId = j.dimension;
+        const id = formatKey({
+            mode,
+            task,
+            model: j.modelId,
+            grader: graderId,
+        });
+        const reason = typeof j.reason === "string" ? j.reason : "";
+        const reasonPreview = reason.length > 280 ? reason.slice(0, 280) : reason;
+        return {
+            id,
+            taskId: j.taskId,
+            modelId: j.modelId,
+            graderId,
+            // Legacy alias — pre-W0051 Studio readers access `.dimension`.
+            // Removed in Slice 6 when those consumers migrate.
+            dimension: graderId,
+            score: j.score,
+            // Inline fallback for offline/cache-skipped runs whose manifest is
+            // empty. Truncated to match the graderJudgments descriptor preview
+            // schema so either source renders identically at the same cap.
+            reasonPreview,
+            // Legacy alias — same truncated text under the old name.
+            reason: reasonPreview,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Failure modes — axes {mode, category}, top-N by count
+// ---------------------------------------------------------------------------
+const FAILURE_MODE_TOP_N = 5;
+function slimFailureModes(full, defaultMode) {
+    const descriptor = ARTIFACT_REGISTRY.failureModes;
+    const formatKey = descriptor.formatEntryKey;
+    if (!formatKey) {
+        throw new Error("slimFailureModes: failureModes descriptor is missing formatEntryKey");
+    }
+    const counts = { ...full.summary };
+    const nonZero = Object.entries(counts).filter(([, n]) => n > 0);
+    nonZero.sort((a, b) => b[1] - a[1]);
+    const topTitles = nonZero
+        .slice(0, FAILURE_MODE_TOP_N)
+        .map(([category, count]) => ({
+        id: formatKey({ mode: defaultMode, category }),
+        category,
+        severity: severityForCount(count),
+        title: toTitleCase(category),
+        count,
+    }));
+    return {
+        counts,
+        topTitles,
+        totalJudgments: full.totalJudgments,
+        classificationRate: full.classificationRate,
+    };
+}
+function severityForCount(count) {
+    if (count >= 10)
+        return "critical";
+    if (count >= 5)
+        return "high";
+    if (count >= 2)
+        return "medium";
+    return "low";
+}
+function toTitleCase(id) {
+    return id
+        .split("-")
+        .map((w) => (w.length === 0 ? w : w[0].toUpperCase() + w.slice(1)))
+        .join(" ");
+}
+// ---------------------------------------------------------------------------
+// Recommendations — bulk artifact; id is a synthetic area--mode composite
+// ---------------------------------------------------------------------------
+const RECOMMENDATION_TOP_N = 3;
+function slimRecommendations(full) {
+    const counts = {};
+    for (const gap of full.gaps) {
+        counts[gap.area] = (counts[gap.area] ?? 0) + 1;
+    }
+    // Sort by priority descending, break ties by estimatedLift.
+    const sorted = [...full.gaps].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0) ||
+        (b.estimatedLift ?? 0) - (a.estimatedLift ?? 0));
+    const top3 = sorted
+        .slice(0, RECOMMENDATION_TOP_N)
+        .map((g) => ({
+        id: gapId(g),
+        area: g.area,
+        title: toTitleCase(g.failureMode),
+        priority: g.priority,
+    }));
+    return {
+        counts,
+        top3,
+        totalGaps: full.gaps.length,
+        totalPotentialLift: full.totalPotentialLift,
+    };
+}
+/**
+ * Synthetic composite id for a gap — the gapReport artifact is bulk, so a
+ * per-gap manifest entry does not exist. This id lets Studio deduplicate
+ * gaps and deep-link within the bulk artifact.
+ */
+function gapId(g) {
+    return `${sanitizeIdSegment(g.area)}--${sanitizeIdSegment(g.failureMode)}`;
+}
+function sanitizeIdSegment(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+// ---------------------------------------------------------------------------
+// Agent behavior — counts + first-N samples per feature
+// ---------------------------------------------------------------------------
+const BEHAVIOR_SAMPLE_N = 5;
+function slimAgentBehavior(full) {
+    return full.map((f) => {
+        const uniqueQueries = dedupe(f.searchQueries);
+        const uniqueSlugs = dedupe(f.docSlugsVisited);
+        return {
+            feature: f.feature,
+            avgDocPagesVisited: f.avgDocPagesVisited,
+            avgNetworkTimeMs: f.avgNetworkTimeMs,
+            avgSearchesPerformed: f.avgSearchesPerformed,
+            tasksWithBehaviorData: f.tasksWithBehaviorData,
+            externalDomains: f.externalDomains,
+            searchQueriesCount: uniqueQueries.length,
+            searchQueriesSample: uniqueQueries.slice(0, BEHAVIOR_SAMPLE_N),
+            docSlugsVisitedCount: uniqueSlugs.length,
+            docSlugsVisitedSample: uniqueSlugs.slice(0, BEHAVIOR_SAMPLE_N),
+        };
+    });
+}
+function dedupe(items) {
+    return [...new Set(items)];
+}

package/dist/_vendor/ailf-core/types/branded-ids.d.ts

@@ -62,6 +62,39 @@ export type RubricId = Brand<string, "RubricId">;
 export type FixtureId = Brand<string, "FixtureId">;
 /** Unique identifier for a build artifact */
 export type ArtifactId = Brand<string, "ArtifactId">;
+/**
+ * The dimensions an artifact is evidence about. Axes determine where the
+ * artifact lives, how its entry key is shaped, and — at module load — whether
+ * its declared layout is allowed.
+ *
+ * Unbounded axes (`task`, `model`, `trial`) force `layout: "per-entry"` at the
+ * registry invariant; the other axes are finite enough that bulk is acceptable.
+ *
+ * `category` identifies a classification bucket for artifacts that partition
+ * per-mode (e.g. `failureModes`, one entry per classified failure category —
+ * D0033 M7, W0051 Slice 2).
+ */
+export type AssociationAxis = "run" | "mode" | "task" | "model" | "grader" | "trial" | "category";
+/**
+ * The sanitized, filename-safe identifier for a single per-entry artifact
+ * object. Produced by `ArtifactDescriptor.formatEntryKey` and parsed by
+ * `parseEntryKey`; not a free-form string at runtime.
+ */
+export type EntryKey = Brand<string, "EntryKey">;
+/**
+ * The subset of `AssociationAxis` values an artifact carries at write time.
+ * Used on the writer API (`emit(type, association, payload)`) and on manifest
+ * entries so the axes that identify the entry are self-describing in storage.
+ *
+ * Canonical axes are strongly-keyed. Descriptors whose per-entry layout is
+ * discriminated by a name that isn't a pipeline axis (e.g. `sinkResults` by
+ * sink name, `callbackRequest` by callback target) read that identifier from
+ * the `name` slot. Keep ad-hoc keys out of the canonical axis list so the
+ * module-load invariant (unbounded-axis ⇒ per-entry) stays crisp.
+ */
+export type AssociationValues = Partial<Record<AssociationAxis, string | number>> & {
+    readonly name?: string;
+};
 /**
  * A success result containing a value.
  */