@sanity/ailf 2.7.0 → 2.8.0

package/dist/_vendor/ailf-core/artifact-registry.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Artifact registry — single source of truth for AILF's external artifact types.
+ *
+ * Every artifact that lives in GCS declares itself here exactly once:
+ * layout, path builder, entry schema, and (for per-entry layouts) key parser.
+ * Eval writers, the API Gateway's signing endpoint, and the Studio hook all
+ * consume this same record.
+ *
+ * Adding a new artifact type = one entry here. No call-site changes needed in
+ * the generic writer / signer / hook — they all iterate the registry.
+ *
+ * @see docs/decisions/D0032-run-anchored-artifact-store.md
+ * @see docs/design-docs/run-artifact-store.md (§ Move 4 — Artifact Registry)
+ */
+import { z } from "zod";
+import type { RunId } from "./types/branded-ids.js";
+/** Layouts supported by the artifact store. */
+export type ArtifactLayout = "bulk" | "per-entry";
+/** The union of every artifact type known to AILF. */
+export type ArtifactType = "testOutputs" | "renderedPrompts" | "rawResults" | "graderPrompts" | "taskDefinitions" | "evalResults" | "traces";
+/**
+ * Result of parsing a per-entry key into a sanitized filename component.
+ * Success carries the sanitized value; failure carries a reason for 4xx responses.
+ */
+export type ParsedEntryKey = {
+    ok: true;
+    sanitized: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Per-type declaration consumed by writers, signers, and readers.
+ *
+ * @typeParam TEntry - The shape of a single entry. For bulk layouts this is
+ *                     the shape of each value in the bulk object's index; for
+ *                     per-entry layouts it's the shape of a single GCS object.
+ */
+export interface ArtifactDescriptor<TEntry = unknown> {
+    /** The artifact type identifier (matches the key in ARTIFACT_REGISTRY). */
+    type: ArtifactType;
+    /** Bulk (one object per run) or per-entry (one object per entryKey). */
+    layout: ArtifactLayout;
+    /** Kebab-case filename stem. Used by both bulk paths and per-entry dir names. */
+    slug: string;
+    /** Zod schema for validating a single entry. */
+    entrySchema: z.ZodType<TEntry>;
+    /**
+     * Build the GCS object path for this artifact.
+     * - bulk: returns `runs/{runId}/{slug}.json`; `entryKey` is ignored.
+     * - per-entry: requires `entryKey`; returns `runs/{runId}/{slug}/{sanitized}.json`.
+     */
+    objectPath: (runId: RunId, entryKey?: string) => string;
+    /**
+     * Validate a per-entry key and return its sanitized filename component.
+     * Only meaningful for `layout === "per-entry"` — unused when layout is bulk,
+     * but may be pre-declared so a future layout flip is a one-line change.
+     */
+    parseEntryKey?: (key: string) => ParsedEntryKey;
+}
+/**
+ * The canonical artifact descriptor for every artifact type. Iterate with
+ * `Object.values(ARTIFACT_REGISTRY)` or look up by `ARTIFACT_REGISTRY[type]`.
+ */
+export declare const ARTIFACT_REGISTRY: Record<ArtifactType, ArtifactDescriptor>;
+/** All artifact types in declaration order. */
+export declare const ARTIFACT_TYPES: readonly ArtifactType[];
+/**
+ * Type guard — validates that an arbitrary string is a known artifact type.
+ * Useful at API Gateway boundaries where the type comes from a URL parameter.
+ */
+export declare function isArtifactType(value: string): value is ArtifactType;

package/dist/_vendor/ailf-core/artifact-registry.js

@@ -0,0 +1,150 @@
+/**
+ * Artifact registry — single source of truth for AILF's external artifact types.
+ *
+ * Every artifact that lives in GCS declares itself here exactly once:
+ * layout, path builder, entry schema, and (for per-entry layouts) key parser.
+ * Eval writers, the API Gateway's signing endpoint, and the Studio hook all
+ * consume this same record.
+ *
+ * Adding a new artifact type = one entry here. No call-site changes needed in
+ * the generic writer / signer / hook — they all iterate the registry.
+ *
+ * @see docs/decisions/D0032-run-anchored-artifact-store.md
+ * @see docs/design-docs/run-artifact-store.md (§ Move 4 — Artifact Registry)
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Path + key helpers
+// ---------------------------------------------------------------------------
+function bulkPath(slug) {
+    return (runId) => `runs/${runId}/${slug}.json`;
+}
+function perEntryPath(slug) {
+    return (runId, entryKey) => {
+        if (entryKey === undefined) {
+            throw new Error(`Artifact "${slug}" uses per-entry layout; an entry key is required`);
+        }
+        const sanitized = sanitizeEntryKey(entryKey);
+        return `runs/${runId}/${slug}/${sanitized}.json`;
+    };
+}
+/**
+ * Convert an entry key (wire format, e.g. `{taskId}::{modelId}`) to a
+ * filename-safe component.
+ *
+ * - `::` → `--` so the wire separator doesn't show up in the filename.
+ * - `/` → `_` so task names like "Content Lake with @sanity/client" don't
+ *   create unintended GCS subdirectories (`.../test-outputs/@sanity/client…`)
+ *   and so `ls` against the per-entry directory shows one row per entry.
+ *
+ * Single colons (`:`) are preserved — modelIds like
+ * `anthropic:messages:claude-opus-4-6` are valid GCS object names.
+ *
+ * NOTE: this mapping is not bijective. A taskId containing literal `--`
+ * combined with a modelId could in theory collide with one whose taskId
+ * contains `::`, and `_` collides with `/`. In practice, production
+ * taskIds don't exercise these combinations. If collision-safety becomes a
+ * concern (e.g., user-provided free-form task names), switch to
+ * percent-encoding or a hash-based scheme at the key boundary.
+ */
+function sanitizeEntryKey(key) {
+    return key.replace(/::/g, "--").replace(/\//g, "_");
+}
+/**
+ * Entry-key parser for artifacts keyed by `{taskId}::{modelId}` — testOutputs
+ * today, other per-entry types in future.
+ *
+ * The separator is `::` (double colon). Either segment may contain single
+ * colons: production model ids commonly look like
+ * `anthropic:messages:claude-opus-4-6`. The constraint is that `::` must
+ * appear exactly once and neither segment is empty, so the API Gateway can
+ * return 400 on malformed input.
+ */
+function parseTaskModelKey(key) {
+    const parts = key.split("::");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        return {
+            ok: false,
+            reason: `Entry key "${key}" must match {taskId}::{modelId} with exactly one "::" separator and non-empty segments`,
+        };
+    }
+    return { ok: true, sanitized: sanitizeEntryKey(key) };
+}
+// ---------------------------------------------------------------------------
+// Entry schemas
+// ---------------------------------------------------------------------------
+const testOutputEntrySchema = z.object({
+    responseOutput: z.string(),
+    responseOutputTruncated: z.boolean(),
+});
+// Aspirational: renderedPrompts / rawResults / traces / etc. currently have
+// loose shapes. Tighten per-type as consumers stabilize.
+const unknownEntry = z.unknown();
+// ---------------------------------------------------------------------------
+// The registry
+// ---------------------------------------------------------------------------
+/**
+ * The canonical artifact descriptor for every artifact type. Iterate with
+ * `Object.values(ARTIFACT_REGISTRY)` or look up by `ARTIFACT_REGISTRY[type]`.
+ */
+export const ARTIFACT_REGISTRY = {
+    testOutputs: {
+        type: "testOutputs",
+        layout: "per-entry",
+        slug: "test-outputs",
+        entrySchema: testOutputEntrySchema,
+        objectPath: perEntryPath("test-outputs"),
+        parseEntryKey: parseTaskModelKey,
+    },
+    renderedPrompts: {
+        type: "renderedPrompts",
+        layout: "bulk",
+        slug: "rendered-prompts",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("rendered-prompts"),
+    },
+    rawResults: {
+        type: "rawResults",
+        layout: "bulk",
+        slug: "raw-results",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("raw-results"),
+    },
+    graderPrompts: {
+        type: "graderPrompts",
+        layout: "bulk",
+        slug: "grader-prompts",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("grader-prompts"),
+    },
+    taskDefinitions: {
+        type: "taskDefinitions",
+        layout: "bulk",
+        slug: "task-definitions",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("task-definitions"),
+    },
+    evalResults: {
+        type: "evalResults",
+        layout: "bulk",
+        slug: "eval-results",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("eval-results"),
+    },
+    traces: {
+        type: "traces",
+        layout: "bulk",
+        slug: "traces",
+        entrySchema: unknownEntry,
+        objectPath: bulkPath("traces"),
+    },
+};
+/** All artifact types in declaration order. */
+export const ARTIFACT_TYPES = Object.keys(ARTIFACT_REGISTRY);
+/**
+ * Type guard — validates that an arbitrary string is a known artifact type.
+ * Useful at API Gateway boundaries where the type comes from a URL parameter.
+ */
+export function isArtifactType(value) {
+    return value in ARTIFACT_REGISTRY;
+}

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

@@ -433,6 +433,6 @@ export interface ExampleRecord {
 }
 export declare const EXAMPLES: Record<ExampleType, ExampleRecord>;
 /** GitHub Actions workflow template for AI Literacy evaluation */
-export declare const workflowYaml = "# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# AI Literacy Evaluation \u2014 GitHub Actions workflow\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n#\n# Evaluates your documentation quality on every pull request.\n# The AILF CLI reads your .ailf/tasks/ definitions, submits them\n# to the AILF API for evaluation, and writes a score report.\n#\n# Prerequisites:\n#   Add one secret to your repository (Settings \u2192 Secrets \u2192 Actions):\n#     AILF_API_KEY \u2014 your API key (starts with ailf_live_sk_)\n#     NPM_TOKEN   \u2014 npm token with read access to @sanity scope\n#\n# Customization:\n#   - Narrow the trigger paths to reduce cost (see comment below)\n#   - Check debug_mode for faster iteration (fewer tests)\n#   - See: https://github.com/sanity-labs/ai-literacy-framework\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nname: AI Literacy Eval\n\non:\n  pull_request:\n    branches: [main]\n    # Runs on every PR to main by default. To reduce cost:\n    #   paths: [\".ailf/**\", \"docs/**\"]\n\n  workflow_dispatch:\n    inputs:\n      debug_mode:\n        description: \"Run in debug mode (fewer tests, faster iteration)\"\n        type: boolean\n        default: false\n\nconcurrency:\n  group: ailf-eval-${{ github.event.pull_request.number || github.ref }}\n  cancel-in-progress: true\n\njobs:\n  evaluate:\n    name: AI Literacy Evaluation\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Configure npm for @sanity scope\n        run:\n          echo \"//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}\" >>\n          ~/.npmrc\n\n      - name: Run evaluation\n        id: eval\n        env:\n          AILF_API_KEY: ${{ secrets.AILF_API_KEY }}\n        run: |\n          npx @sanity/ailf@latest pipeline --remote \\\n            --output /tmp/ailf-report.md \\\n            ${{ inputs.debug_mode && '--debug' || '' }}\n\n      - name: Post PR comment\n        if: always() && github.event_name == 'pull_request'\n        uses: actions/github-script@v7\n        with:\n          script: |\n            const fs = require('fs');\n\n            // --- Constants ---\n            const MARKER = '<!-- ailf-score-report -->';\n            const HISTORY_START = '<!-- ailf-score-history -->';\n            const HISTORY_END = '<!-- /ailf-score-history -->';\n            const MAX_HISTORY = 3; // keep at most 3 prior runs\n\n            // --- Read new report ---\n            let newReport;\n            try {\n              newReport = fs.readFileSync('/tmp/ailf-report.md', 'utf-8');\n            } catch {\n              newReport = `## \u26A0\uFE0F AI Literacy Evaluation\\n\\nNo report generated. Check the [workflow logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).`;\n            }\n\n            const prNumber = context.issue?.number || context.payload?.pull_request?.number;\n            if (!prNumber) {\n              console.log('No PR number found, skipping comment');\n              return;\n            }\n\n            // --- Find existing comment ---\n            const { data: comments } = await github.rest.issues.listComments({\n              owner: context.repo.owner, repo: context.repo.repo,\n              issue_number: prNumber,\n            });\n            const existing = comments.find(c => c.body?.includes(MARKER));\n\n            // --- Build history from previous comment ---\n            let historyEntries = [];\n            if (existing) {\n              const oldBody = existing.body || '';\n\n              // Collect existing collapsed history entries\n              const histStart = oldBody.indexOf(HISTORY_START);\n              const histEnd = oldBody.indexOf(HISTORY_END);\n              if (histStart !== -1 && histEnd !== -1) {\n                const historyContent = oldBody.slice(histStart + HISTORY_START.length, histEnd).trim();\n                // Split on </details> boundaries to get individual entries\n                if (historyContent) {\n                  historyEntries = historyContent\n                    .split(/<\\/details>\\s*/)\n                    .map(s => s.trim())\n                    .filter(s => s.startsWith('<details>'))\n                    .map(s => s + '\\n</details>');\n                }\n              }\n\n              // Extract the current report (will become the newest history entry)\n              let previousReport = '';\n              if (histStart !== -1) {\n                // Report is between MARKER and the \"Previous runs\" heading (or history section)\n                const markerIdx = oldBody.indexOf(MARKER);\n                // Find the --- separator before history\n                const separatorIdx = oldBody.lastIndexOf('---', histStart);\n                const endIdx = separatorIdx > markerIdx ? separatorIdx : histStart;\n                previousReport = oldBody.slice(markerIdx + MARKER.length, endIdx).trim();\n              } else {\n                // No history yet \u2014 everything after MARKER is the report\n                const markerIdx = oldBody.indexOf(MARKER);\n                if (markerIdx !== -1) {\n                  previousReport = oldBody.slice(markerIdx + MARKER.length).trim();\n                }\n              }\n\n              // Collapse the previous report into a <details> entry\n              if (previousReport) {\n                const scoreMatch = previousReport.match(/Overall:\\s*(\\d+)\\/100/);\n                const score = scoreMatch ? scoreMatch[1] : '?';\n                const dateMatch = previousReport.match(/Generated by.*?\u00B7\\s*([^\u00B7<\\n*]+)/);\n                const date = dateMatch\n                  ? dateMatch[1].trim()\n                  : new Date().toISOString().slice(0, 16).replace('T', ' ') + ' UTC';\n                const entry = `<details>\\n<summary>\uD83D\uDCDC ${date} \u2014 ${score}/100</summary>\\n\\n${previousReport}\\n\\n</details>`;\n                historyEntries.unshift(entry); // newest first\n              }\n\n              // Enforce max history limit\n              historyEntries = historyEntries.slice(0, MAX_HISTORY);\n            }\n\n            // --- Assemble final comment ---\n            const historySection = historyEntries.length > 0\n              ? `\\n\\n---\\n\\n### \uD83D\uDCDC Previous runs\\n\\n${HISTORY_START}\\n${historyEntries.join('\\n\\n')}\\n${HISTORY_END}`\n              : '';\n            const finalBody = `${MARKER}\\n${newReport}${historySection}`;\n\n            if (existing) {\n              await github.rest.issues.updateComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                comment_id: existing.id, body: finalBody,\n              });\n              console.log(`Updated comment (${historyEntries.length} history entries)`);\n            } else {\n              await github.rest.issues.createComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                issue_number: prNumber, body: finalBody,\n              });\n              console.log('Created new PR comment');\n            }\n\n      - name: Summary\n        if: always()\n        run: |\n          if [ -f /tmp/ailf-report.md ]; then\n            cat /tmp/ailf-report.md >> \"$GITHUB_STEP_SUMMARY\"\n          else\n            echo \"## \u26A0\uFE0F AI Literacy Evaluation\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"No report generated. Check the workflow logs.\" >> \"$GITHUB_STEP_SUMMARY\"\n          fi\n";
+export declare const workflowYaml = "# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# AI Literacy Evaluation \u2014 GitHub Actions workflow\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n#\n# Evaluates your documentation quality on every pull request.\n# The AILF CLI reads your .ailf/tasks/ definitions, submits them\n# to the AILF API for evaluation, and writes a score report.\n#\n# Prerequisites:\n#   Add one secret to your repository (Settings \u2192 Secrets \u2192 Actions):\n#     AILF_API_KEY \u2014 your API key (starts with ailf_live_sk_)\n#\n#   @sanity/ailf is published with public npm access, so no npm token is\n#   needed to install the CLI.\n#\n# Customization:\n#   - Narrow the trigger paths to reduce cost (see comment below)\n#   - Check debug_mode for faster iteration (fewer tests)\n#   - See: https://github.com/sanity-labs/ai-literacy-framework\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nname: AI Literacy Eval\n\non:\n  pull_request:\n    branches: [main]\n    # Runs on every PR to main by default. To reduce cost:\n    #   paths: [\".ailf/**\", \"docs/**\"]\n\n  workflow_dispatch:\n    inputs:\n      debug_mode:\n        description: \"Run in debug mode (fewer tests, faster iteration)\"\n        type: boolean\n        default: false\n\nconcurrency:\n  group: ailf-eval-${{ github.event.pull_request.number || github.ref }}\n  cancel-in-progress: true\n\njobs:\n  evaluate:\n    name: AI Literacy Evaluation\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Run evaluation\n        id: eval\n        env:\n          AILF_API_KEY: ${{ secrets.AILF_API_KEY }}\n        run: |\n          npx @sanity/ailf@latest pipeline --remote \\\n            --output /tmp/ailf-report.md \\\n            ${{ inputs.debug_mode && '--debug' || '' }}\n\n      - name: Post PR comment\n        if: always() && github.event_name == 'pull_request'\n        uses: actions/github-script@v7\n        with:\n          script: |\n            const fs = require('fs');\n\n            // --- Constants ---\n            const MARKER = '<!-- ailf-score-report -->';\n            const HISTORY_START = '<!-- ailf-score-history -->';\n            const HISTORY_END = '<!-- /ailf-score-history -->';\n            const MAX_HISTORY = 3; // keep at most 3 prior runs\n\n            // --- Read new report ---\n            let newReport;\n            try {\n              newReport = fs.readFileSync('/tmp/ailf-report.md', 'utf-8');\n            } catch {\n              newReport = `## \u26A0\uFE0F AI Literacy Evaluation\\n\\nNo report generated. Check the [workflow logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).`;\n            }\n\n            const prNumber = context.issue?.number || context.payload?.pull_request?.number;\n            if (!prNumber) {\n              console.log('No PR number found, skipping comment');\n              return;\n            }\n\n            // --- Find existing comment ---\n            const { data: comments } = await github.rest.issues.listComments({\n              owner: context.repo.owner, repo: context.repo.repo,\n              issue_number: prNumber,\n            });\n            const existing = comments.find(c => c.body?.includes(MARKER));\n\n            // --- Build history from previous comment ---\n            let historyEntries = [];\n            if (existing) {\n              const oldBody = existing.body || '';\n\n              // Collect existing collapsed history entries\n              const histStart = oldBody.indexOf(HISTORY_START);\n              const histEnd = oldBody.indexOf(HISTORY_END);\n              if (histStart !== -1 && histEnd !== -1) {\n                const historyContent = oldBody.slice(histStart + HISTORY_START.length, histEnd).trim();\n                // Split on </details> boundaries to get individual entries\n                if (historyContent) {\n                  historyEntries = historyContent\n                    .split(/<\\/details>\\s*/)\n                    .map(s => s.trim())\n                    .filter(s => s.startsWith('<details>'))\n                    .map(s => s + '\\n</details>');\n                }\n              }\n\n              // Extract the current report (will become the newest history entry)\n              let previousReport = '';\n              if (histStart !== -1) {\n                // Report is between MARKER and the \"Previous runs\" heading (or history section)\n                const markerIdx = oldBody.indexOf(MARKER);\n                // Find the --- separator before history\n                const separatorIdx = oldBody.lastIndexOf('---', histStart);\n                const endIdx = separatorIdx > markerIdx ? separatorIdx : histStart;\n                previousReport = oldBody.slice(markerIdx + MARKER.length, endIdx).trim();\n              } else {\n                // No history yet \u2014 everything after MARKER is the report\n                const markerIdx = oldBody.indexOf(MARKER);\n                if (markerIdx !== -1) {\n                  previousReport = oldBody.slice(markerIdx + MARKER.length).trim();\n                }\n              }\n\n              // Collapse the previous report into a <details> entry\n              if (previousReport) {\n                const scoreMatch = previousReport.match(/Overall:\\s*(\\d+)\\/100/);\n                const score = scoreMatch ? scoreMatch[1] : '?';\n                const dateMatch = previousReport.match(/Generated by.*?\u00B7\\s*([^\u00B7<\\n*]+)/);\n                const date = dateMatch\n                  ? dateMatch[1].trim()\n                  : new Date().toISOString().slice(0, 16).replace('T', ' ') + ' UTC';\n                const entry = `<details>\\n<summary>\uD83D\uDCDC ${date} \u2014 ${score}/100</summary>\\n\\n${previousReport}\\n\\n</details>`;\n                historyEntries.unshift(entry); // newest first\n              }\n\n              // Enforce max history limit\n              historyEntries = historyEntries.slice(0, MAX_HISTORY);\n            }\n\n            // --- Assemble final comment ---\n            const historySection = historyEntries.length > 0\n              ? `\\n\\n---\\n\\n### \uD83D\uDCDC Previous runs\\n\\n${HISTORY_START}\\n${historyEntries.join('\\n\\n')}\\n${HISTORY_END}`\n              : '';\n            const finalBody = `${MARKER}\\n${newReport}${historySection}`;\n\n            if (existing) {\n              await github.rest.issues.updateComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                comment_id: existing.id, body: finalBody,\n              });\n              console.log(`Updated comment (${historyEntries.length} history entries)`);\n            } else {\n              await github.rest.issues.createComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                issue_number: prNumber, body: finalBody,\n              });\n              console.log('Created new PR comment');\n            }\n\n      - name: Summary\n        if: always()\n        run: |\n          if [ -f /tmp/ailf-report.md ]; then\n            cat /tmp/ailf-report.md >> \"$GITHUB_STEP_SUMMARY\"\n          else\n            echo \"## \u26A0\uFE0F AI Literacy Evaluation\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"No report generated. Check the workflow logs.\" >> \"$GITHUB_STEP_SUMMARY\"\n          fi\n";
 /** TypeScript project configuration template (ailf.config.ts) */
 export declare const ailfConfigTs = "/**\n * .ailf/ailf.config.ts \u2014 AI Literacy Framework project configuration.\n *\n * This file configures how the AILF evaluation pipeline runs in this\n * repository. Place it at .ailf/ailf.config.ts in your project root.\n *\n * Evaluations are submitted to the AILF API (ailf-api.sanity.build).\n * The API handles LLM calls, doc fetching, grading, and report\n * publishing. Your repo only needs one secret: AILF_API_KEY.\n *\n * Docs: https://github.com/sanity-labs/ai-literacy-framework\n */\n\nexport default {\n  /**\n   * Documentation source \u2014 which docs are being evaluated.\n   *\n   * This tells the pipeline which Sanity project and dataset contain\n   * the documentation under test. For most users, this is Sanity's own\n   * docs project.\n   */\n  source: {\n    /** Sanity project ID (find yours at sanity.io/manage) */\n    projectId: \"3do82whm\",\n    /** The dataset to query (e.g., \"production\", \"next\") */\n    dataset: \"next\",\n    /**\n     * The public URL of your documentation site.\n     * Used by agentic mode to test agent discoverability.\n     */\n    baseUrl: \"https://www.sanity.io/docs\",\n  },\n\n  /**\n   * Trigger configuration \u2014 when evaluations run automatically.\n   *\n   * Each key is a trigger context. The pipeline checks which trigger\n   * matches the current execution context (PR, merge, schedule, etc.)\n   * and applies its settings.\n   *\n   * Mode options:\n   *   \"validate-only\" \u2014 check that task files parse correctly (fast, no LLM calls)\n   *   \"eval\"          \u2014 run the full evaluation pipeline\n   */\n  triggers: {\n    /** On pull requests: just validate task files parse correctly. */\n    pr: {\n      mode: \"validate-only\",\n    },\n\n    /** When .ailf/ files change in a PR: run a real evaluation. */\n    \"pr-task-change\": {\n      mode: \"eval\",\n      paths: [\".ailf/**\"],\n    },\n\n    /** On merge to main: run evaluation (non-blocking). */\n    main: {\n      mode: \"eval\",\n      blocking: false,\n      notify: true,\n    },\n  },\n}\n";

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

@@ -630,7 +630,7 @@ export const EXAMPLES = {
 // Raw file exports (non-data files, exported as raw strings)
 // ---------------------------------------------------------------------------
 /** GitHub Actions workflow template for AI Literacy evaluation */
-export const workflowYaml = "# ──────────────────────────────────────────────────────────────────────\n# AI Literacy Evaluation — GitHub Actions workflow\n# ──────────────────────────────────────────────────────────────────────\n#\n# Evaluates your documentation quality on every pull request.\n# The AILF CLI reads your .ailf/tasks/ definitions, submits them\n# to the AILF API for evaluation, and writes a score report.\n#\n# Prerequisites:\n#   Add one secret to your repository (Settings → Secrets → Actions):\n#     AILF_API_KEY — your API key (starts with ailf_live_sk_)\n#     NPM_TOKEN   — npm token with read access to @sanity scope\n#\n# Customization:\n#   - Narrow the trigger paths to reduce cost (see comment below)\n#   - Check debug_mode for faster iteration (fewer tests)\n#   - See: https://github.com/sanity-labs/ai-literacy-framework\n# ──────────────────────────────────────────────────────────────────────\n\nname: AI Literacy Eval\n\non:\n  pull_request:\n    branches: [main]\n    # Runs on every PR to main by default. To reduce cost:\n    #   paths: [\".ailf/**\", \"docs/**\"]\n\n  workflow_dispatch:\n    inputs:\n      debug_mode:\n        description: \"Run in debug mode (fewer tests, faster iteration)\"\n        type: boolean\n        default: false\n\nconcurrency:\n  group: ailf-eval-${{ github.event.pull_request.number || github.ref }}\n  cancel-in-progress: true\n\njobs:\n  evaluate:\n    name: AI Literacy Evaluation\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Configure npm for @sanity scope\n        run:\n          echo \"//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}\" >>\n          ~/.npmrc\n\n      - name: Run evaluation\n        id: eval\n        env:\n          AILF_API_KEY: ${{ secrets.AILF_API_KEY }}\n        run: |\n          npx @sanity/ailf@latest pipeline --remote \\\n            --output /tmp/ailf-report.md \\\n            ${{ inputs.debug_mode && '--debug' || '' }}\n\n      - name: Post PR comment\n        if: always() && github.event_name == 'pull_request'\n        uses: actions/github-script@v7\n        with:\n          script: |\n            const fs = require('fs');\n\n            // --- Constants ---\n            const MARKER = '<!-- ailf-score-report -->';\n            const HISTORY_START = '<!-- ailf-score-history -->';\n            const HISTORY_END = '<!-- /ailf-score-history -->';\n            const MAX_HISTORY = 3; // keep at most 3 prior runs\n\n            // --- Read new report ---\n            let newReport;\n            try {\n              newReport = fs.readFileSync('/tmp/ailf-report.md', 'utf-8');\n            } catch {\n              newReport = `## ⚠️ AI Literacy Evaluation\\n\\nNo report generated. Check the [workflow logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).`;\n            }\n\n            const prNumber = context.issue?.number || context.payload?.pull_request?.number;\n            if (!prNumber) {\n              console.log('No PR number found, skipping comment');\n              return;\n            }\n\n            // --- Find existing comment ---\n            const { data: comments } = await github.rest.issues.listComments({\n              owner: context.repo.owner, repo: context.repo.repo,\n              issue_number: prNumber,\n            });\n            const existing = comments.find(c => c.body?.includes(MARKER));\n\n            // --- Build history from previous comment ---\n            let historyEntries = [];\n            if (existing) {\n              const oldBody = existing.body || '';\n\n              // Collect existing collapsed history entries\n              const histStart = oldBody.indexOf(HISTORY_START);\n              const histEnd = oldBody.indexOf(HISTORY_END);\n              if (histStart !== -1 && histEnd !== -1) {\n                const historyContent = oldBody.slice(histStart + HISTORY_START.length, histEnd).trim();\n                // Split on </details> boundaries to get individual entries\n                if (historyContent) {\n                  historyEntries = historyContent\n                    .split(/<\\/details>\\s*/)\n                    .map(s => s.trim())\n                    .filter(s => s.startsWith('<details>'))\n                    .map(s => s + '\\n</details>');\n                }\n              }\n\n              // Extract the current report (will become the newest history entry)\n              let previousReport = '';\n              if (histStart !== -1) {\n                // Report is between MARKER and the \"Previous runs\" heading (or history section)\n                const markerIdx = oldBody.indexOf(MARKER);\n                // Find the --- separator before history\n                const separatorIdx = oldBody.lastIndexOf('---', histStart);\n                const endIdx = separatorIdx > markerIdx ? separatorIdx : histStart;\n                previousReport = oldBody.slice(markerIdx + MARKER.length, endIdx).trim();\n              } else {\n                // No history yet — everything after MARKER is the report\n                const markerIdx = oldBody.indexOf(MARKER);\n                if (markerIdx !== -1) {\n                  previousReport = oldBody.slice(markerIdx + MARKER.length).trim();\n                }\n              }\n\n              // Collapse the previous report into a <details> entry\n              if (previousReport) {\n                const scoreMatch = previousReport.match(/Overall:\\s*(\\d+)\\/100/);\n                const score = scoreMatch ? scoreMatch[1] : '?';\n                const dateMatch = previousReport.match(/Generated by.*?·\\s*([^·<\\n*]+)/);\n                const date = dateMatch\n                  ? dateMatch[1].trim()\n                  : new Date().toISOString().slice(0, 16).replace('T', ' ') + ' UTC';\n                const entry = `<details>\\n<summary>📜 ${date} — ${score}/100</summary>\\n\\n${previousReport}\\n\\n</details>`;\n                historyEntries.unshift(entry); // newest first\n              }\n\n              // Enforce max history limit\n              historyEntries = historyEntries.slice(0, MAX_HISTORY);\n            }\n\n            // --- Assemble final comment ---\n            const historySection = historyEntries.length > 0\n              ? `\\n\\n---\\n\\n### 📜 Previous runs\\n\\n${HISTORY_START}\\n${historyEntries.join('\\n\\n')}\\n${HISTORY_END}`\n              : '';\n            const finalBody = `${MARKER}\\n${newReport}${historySection}`;\n\n            if (existing) {\n              await github.rest.issues.updateComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                comment_id: existing.id, body: finalBody,\n              });\n              console.log(`Updated comment (${historyEntries.length} history entries)`);\n            } else {\n              await github.rest.issues.createComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                issue_number: prNumber, body: finalBody,\n              });\n              console.log('Created new PR comment');\n            }\n\n      - name: Summary\n        if: always()\n        run: |\n          if [ -f /tmp/ailf-report.md ]; then\n            cat /tmp/ailf-report.md >> \"$GITHUB_STEP_SUMMARY\"\n          else\n            echo \"## ⚠️ AI Literacy Evaluation\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"No report generated. Check the workflow logs.\" >> \"$GITHUB_STEP_SUMMARY\"\n          fi\n";
+export const workflowYaml = "# ──────────────────────────────────────────────────────────────────────\n# AI Literacy Evaluation — GitHub Actions workflow\n# ──────────────────────────────────────────────────────────────────────\n#\n# Evaluates your documentation quality on every pull request.\n# The AILF CLI reads your .ailf/tasks/ definitions, submits them\n# to the AILF API for evaluation, and writes a score report.\n#\n# Prerequisites:\n#   Add one secret to your repository (Settings → Secrets → Actions):\n#     AILF_API_KEY — your API key (starts with ailf_live_sk_)\n#\n#   @sanity/ailf is published with public npm access, so no npm token is\n#   needed to install the CLI.\n#\n# Customization:\n#   - Narrow the trigger paths to reduce cost (see comment below)\n#   - Check debug_mode for faster iteration (fewer tests)\n#   - See: https://github.com/sanity-labs/ai-literacy-framework\n# ──────────────────────────────────────────────────────────────────────\n\nname: AI Literacy Eval\n\non:\n  pull_request:\n    branches: [main]\n    # Runs on every PR to main by default. To reduce cost:\n    #   paths: [\".ailf/**\", \"docs/**\"]\n\n  workflow_dispatch:\n    inputs:\n      debug_mode:\n        description: \"Run in debug mode (fewer tests, faster iteration)\"\n        type: boolean\n        default: false\n\nconcurrency:\n  group: ailf-eval-${{ github.event.pull_request.number || github.ref }}\n  cancel-in-progress: true\n\njobs:\n  evaluate:\n    name: AI Literacy Evaluation\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Run evaluation\n        id: eval\n        env:\n          AILF_API_KEY: ${{ secrets.AILF_API_KEY }}\n        run: |\n          npx @sanity/ailf@latest pipeline --remote \\\n            --output /tmp/ailf-report.md \\\n            ${{ inputs.debug_mode && '--debug' || '' }}\n\n      - name: Post PR comment\n        if: always() && github.event_name == 'pull_request'\n        uses: actions/github-script@v7\n        with:\n          script: |\n            const fs = require('fs');\n\n            // --- Constants ---\n            const MARKER = '<!-- ailf-score-report -->';\n            const HISTORY_START = '<!-- ailf-score-history -->';\n            const HISTORY_END = '<!-- /ailf-score-history -->';\n            const MAX_HISTORY = 3; // keep at most 3 prior runs\n\n            // --- Read new report ---\n            let newReport;\n            try {\n              newReport = fs.readFileSync('/tmp/ailf-report.md', 'utf-8');\n            } catch {\n              newReport = `## ⚠️ AI Literacy Evaluation\\n\\nNo report generated. Check the [workflow logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).`;\n            }\n\n            const prNumber = context.issue?.number || context.payload?.pull_request?.number;\n            if (!prNumber) {\n              console.log('No PR number found, skipping comment');\n              return;\n            }\n\n            // --- Find existing comment ---\n            const { data: comments } = await github.rest.issues.listComments({\n              owner: context.repo.owner, repo: context.repo.repo,\n              issue_number: prNumber,\n            });\n            const existing = comments.find(c => c.body?.includes(MARKER));\n\n            // --- Build history from previous comment ---\n            let historyEntries = [];\n            if (existing) {\n              const oldBody = existing.body || '';\n\n              // Collect existing collapsed history entries\n              const histStart = oldBody.indexOf(HISTORY_START);\n              const histEnd = oldBody.indexOf(HISTORY_END);\n              if (histStart !== -1 && histEnd !== -1) {\n                const historyContent = oldBody.slice(histStart + HISTORY_START.length, histEnd).trim();\n                // Split on </details> boundaries to get individual entries\n                if (historyContent) {\n                  historyEntries = historyContent\n                    .split(/<\\/details>\\s*/)\n                    .map(s => s.trim())\n                    .filter(s => s.startsWith('<details>'))\n                    .map(s => s + '\\n</details>');\n                }\n              }\n\n              // Extract the current report (will become the newest history entry)\n              let previousReport = '';\n              if (histStart !== -1) {\n                // Report is between MARKER and the \"Previous runs\" heading (or history section)\n                const markerIdx = oldBody.indexOf(MARKER);\n                // Find the --- separator before history\n                const separatorIdx = oldBody.lastIndexOf('---', histStart);\n                const endIdx = separatorIdx > markerIdx ? separatorIdx : histStart;\n                previousReport = oldBody.slice(markerIdx + MARKER.length, endIdx).trim();\n              } else {\n                // No history yet — everything after MARKER is the report\n                const markerIdx = oldBody.indexOf(MARKER);\n                if (markerIdx !== -1) {\n                  previousReport = oldBody.slice(markerIdx + MARKER.length).trim();\n                }\n              }\n\n              // Collapse the previous report into a <details> entry\n              if (previousReport) {\n                const scoreMatch = previousReport.match(/Overall:\\s*(\\d+)\\/100/);\n                const score = scoreMatch ? scoreMatch[1] : '?';\n                const dateMatch = previousReport.match(/Generated by.*?·\\s*([^·<\\n*]+)/);\n                const date = dateMatch\n                  ? dateMatch[1].trim()\n                  : new Date().toISOString().slice(0, 16).replace('T', ' ') + ' UTC';\n                const entry = `<details>\\n<summary>📜 ${date} — ${score}/100</summary>\\n\\n${previousReport}\\n\\n</details>`;\n                historyEntries.unshift(entry); // newest first\n              }\n\n              // Enforce max history limit\n              historyEntries = historyEntries.slice(0, MAX_HISTORY);\n            }\n\n            // --- Assemble final comment ---\n            const historySection = historyEntries.length > 0\n              ? `\\n\\n---\\n\\n### 📜 Previous runs\\n\\n${HISTORY_START}\\n${historyEntries.join('\\n\\n')}\\n${HISTORY_END}`\n              : '';\n            const finalBody = `${MARKER}\\n${newReport}${historySection}`;\n\n            if (existing) {\n              await github.rest.issues.updateComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                comment_id: existing.id, body: finalBody,\n              });\n              console.log(`Updated comment (${historyEntries.length} history entries)`);\n            } else {\n              await github.rest.issues.createComment({\n                owner: context.repo.owner, repo: context.repo.repo,\n                issue_number: prNumber, body: finalBody,\n              });\n              console.log('Created new PR comment');\n            }\n\n      - name: Summary\n        if: always()\n        run: |\n          if [ -f /tmp/ailf-report.md ]; then\n            cat /tmp/ailf-report.md >> \"$GITHUB_STEP_SUMMARY\"\n          else\n            echo \"## ⚠️ AI Literacy Evaluation\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"\" >> \"$GITHUB_STEP_SUMMARY\"\n            echo \"No report generated. Check the workflow logs.\" >> \"$GITHUB_STEP_SUMMARY\"\n          fi\n";
 // ---------------------------------------------------------------------------
 // TypeScript template exports (for ailf init --output-format ts)
 // ---------------------------------------------------------------------------

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

@@ -15,8 +15,9 @@ export * from "./schemas/index.js";
 export * from "./ports/index.js";
 export * from "./services/index.js";
 export * from "./examples/index.js";
+export * from "./artifact-registry.js";
 export { defineConfig, defineFeatures, defineModeBase, defineModels, definePricingTable, definePreset, definePrompts, defineRubrics, defineSchedules, defineSinks, defineSources, defineTask, defineThresholds, } from "./config-helpers.js";
 export type { PricingEntry, PromptEntry, SourceEntry, } from "./config-helpers.js";
 export { env } from "./env-helper.js";
 export { NoOpArtifactCollector } from "./artifact-capture/noop-collector.js";
-export { NoOpArtifactUploader } from "./ports/artifact-uploader.js";
+export { NoOpArtifactWriter } from "./ports/artifact-writer.js";

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

@@ -15,10 +15,11 @@ export * from "./schemas/index.js";
 export * from "./ports/index.js";
 export * from "./services/index.js";
 export * from "./examples/index.js";
+export * from "./artifact-registry.js";
 // ---------------------------------------------------------------------------
 // Architecture overhaul — Phase 0 helpers
 // ---------------------------------------------------------------------------
 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 { NoOpArtifactUploader } from "./ports/artifact-uploader.js";
+export { NoOpArtifactWriter } from "./ports/artifact-writer.js";

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

@@ -62,7 +62,7 @@ export interface CaptureFlushResult {
     compressed: boolean;
 }
 /** A single entry in the capture manifest. */
-export interface ArtifactManifestEntry {
+export interface CaptureManifestEntry {
     /** Pipeline step that produced this artifact */
     step: string;
     /** Artifact type identifier */
@@ -79,7 +79,7 @@ export interface ArtifactManifestEntry {
     meta?: Record<string, unknown>;
 }
 /** The manifest.json written to each capture directory. */
-export interface ArtifactManifest {
+export interface CaptureManifest {
     version: 1;
     captureId: string;
     startedAt: string;
@@ -90,5 +90,5 @@ export interface ArtifactManifest {
         source?: string;
         areas?: string[];
     };
-    artifacts: ArtifactManifestEntry[];
+    artifacts: CaptureManifestEntry[];
 }

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

@@ -0,0 +1,56 @@
+/**
+ * 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`.
+ *
+ * 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.
+ *
+ * @see docs/decisions/D0032-run-anchored-artifact-store.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 { 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`.
+ */
+export interface ArtifactEntry<TData = unknown> {
+    key: string;
+    data: TData;
+}
+export interface ArtifactWriter {
+    /**
+     * Write a bulk artifact — one JSON object per (runId, type).
+     *
+     * @returns An `ArtifactRef` pointing at `runs/{runId}/{slug}.json`, or
+     *          `null` when upload is skipped or fails (P5: non-blocking).
+     */
+    writeBulk(type: ArtifactType, runId: RunId, data: unknown): Promise<ArtifactRef | null>;
+    /**
+     * Write a per-entry artifact — one JSON object per entry, all under
+     * `runs/{runId}/{slug}/`.
+     *
+     * The returned `ArtifactRef.entries` inlines the catalog so consumers
+     * can render drill-down state without a second listing call.
+     */
+    writePerEntry(type: ArtifactType, runId: RunId, entries: readonly ArtifactEntry[]): 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>;
+}
+/** No-op writer — every method returns null. Used when no storage is configured. */
+export declare class NoOpArtifactWriter implements ArtifactWriter {
+    writeBulk(): Promise<null>;
+    writePerEntry(): Promise<null>;
+    writeManifest(): Promise<null>;
+}

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

@@ -0,0 +1,28 @@
+/**
+ * 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`.
+ *
+ * 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.
+ *
+ * @see docs/decisions/D0032-run-anchored-artifact-store.md
+ * @see packages/core/src/artifact-registry.ts
+ */
+/** No-op writer — every method returns null. Used when no storage is configured. */
+export class NoOpArtifactWriter {
+    async writeBulk() {
+        return null;
+    }
+    async writePerEntry() {
+        return null;
+    }
+    async writeManifest() {
+        return null;
+    }
+}

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

@@ -11,9 +11,10 @@
  * Fields marked optional are transitional — they will become required
  * as downstream consumers are converted to use them.
  */
+import type { RunId } from "../types/branded-ids.js";
 import type { DebugOptions, EvalMode, PluginRegistry } from "../types/index.js";
 import type { ArtifactCollector } from "./artifact-collector.js";
-import type { ArtifactUploader } from "./artifact-uploader.js";
+import type { ArtifactWriter } from "./artifact-writer.js";
 import type { CacheStore } from "./cache-store.js";
 import type { DocFetcher } from "./doc-fetcher.js";
 import type { EvalRunner } from "./eval-runner.js";
@@ -197,8 +198,8 @@ export interface ResolvedConfig {
  * Created per-test by createTestContext().
  */
 export interface AppContext {
-    /** Report artifact uploader — uploads structured files to GCS for Studio (D0030) */
-    readonly artifactUploader?: ArtifactUploader;
+    /** Artifact writer — writes run artifacts + manifest to GCS (D0032) */
+    readonly artifactWriter?: ArtifactWriter;
     /** Evaluation caching (filesystem + optional Content Lake fallback) */
     readonly cache?: CacheStore;
     /** Artifact capture collector (no-op when --capture is not set) */
@@ -220,6 +221,15 @@ export interface AppContext {
      * require this field.
      */
     readonly reportStore?: ReportStorePort;
+    /**
+     * Identity for this pipeline run. Generated once at composition-root
+     * time; every step reads it from the context rather than regenerating.
+     * Artifacts anchor to this id (`gs://…/runs/{runId}/…`) regardless of
+     * whether the run eventually publishes a report.
+     *
+     * @see docs/decisions/D0032-run-anchored-artifact-store.md
+     */
+    readonly runId: RunId;
     /**
      * Report delivery sinks (Slack, BigQuery, webhooks).
      * Empty array when no sinks are configured.

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

@@ -4,9 +4,9 @@
  * Ports define the contracts between the domain kernel and the outside world.
  * Adapters (in packages/eval) implement these interfaces.
  */
-export type { ArtifactCollector, ArtifactManifest, ArtifactManifestEntry, CaptureFlushResult, } from "./artifact-collector.js";
-export type { ArtifactUploader } from "./artifact-uploader.js";
-export { NoOpArtifactUploader } from "./artifact-uploader.js";
+export type { ArtifactCollector, CaptureFlushResult, CaptureManifest, CaptureManifestEntry, } from "./artifact-collector.js";
+export type { ArtifactEntry, ArtifactWriter } from "./artifact-writer.js";
+export { NoOpArtifactWriter } from "./artifact-writer.js";
 export type { ArtifactContentDiff, CaptureDiffReport, ComparisonMode, ComparisonOptions, InventoryDiff, JsonDiffEntry, MetadataComparison, ScoreComparison, SecurityScan, TimingComparison, } from "./capture-comparator.js";
 export type { CacheEntryMetadata, CacheKey, CacheLookupResult, CacheRecordInput, CacheStore, } from "./cache-store.js";
 export type { ConfigSource } from "./config-source.js";

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

@@ -4,5 +4,5 @@
  * Ports define the contracts between the domain kernel and the outside world.
  * Adapters (in packages/eval) implement these interfaces.
  */
-export { NoOpArtifactUploader } from "./artifact-uploader.js";
+export { NoOpArtifactWriter } from "./artifact-writer.js";
 export { canonicalDocRefLabel, isIdRef, isPathRef, isPerspectiveRef, isSlugRef, isTemplatedAssertion, } from "./task-source.js";

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

@@ -104,6 +104,15 @@ export declare function taskId(raw: string): Result<TaskId, IdValidationError>;
  * Valid format: `run_` prefix followed by alphanumeric characters.
  */
 export declare function runId(raw: string): Result<RunId, IdValidationError>;
+/**
+ * Generate a new `RunId` using a time-sortable UUIDv7 payload.
+ *
+ * The `run_` prefix plus the hyphen-stripped UUIDv7 yields 36 characters
+ * that sort lexicographically by creation time — same pattern used for
+ * `ReportId`. One generator call per pipeline invocation; every step
+ * reads the resulting id from `AppContext.runId`.
+ */
+export declare function generateRunId(): RunId;
 /**
  * Parse a raw string into a `SuiteId`.
  *

package/dist/_vendor/ailf-core/types/branded-ids.js

@@ -59,6 +59,27 @@ export function runId(raw) {
     }
     return ok(raw);
 }
+/**
+ * Generate a new `RunId` using a time-sortable UUIDv7 payload.
+ *
+ * The `run_` prefix plus the hyphen-stripped UUIDv7 yields 36 characters
+ * that sort lexicographically by creation time — same pattern used for
+ * `ReportId`. One generator call per pipeline invocation; every step
+ * reads the resulting id from `AppContext.runId`.
+ */
+export function generateRunId() {
+    const now = Date.now();
+    const uuid = crypto.randomUUID();
+    // UUID v7: encode 48-bit timestamp in the first 12 hex chars
+    const hex = now.toString(16).padStart(12, "0");
+    const v7 = hex.slice(0, 8) +
+        hex.slice(8, 12) +
+        "7" +
+        uuid.slice(15, 18) +
+        uuid.slice(19, 23) +
+        uuid.slice(24);
+    return `run_${v7}`;
+}
 /**
  * Parse a raw string into a `SuiteId`.
  *