@sanity/ailf 5.0.0 → 6.1.0

package/dist/composition-root.js

@@ -15,7 +15,10 @@
  * @see packages/core/src/ports/context.ts — AppContext interface
  * @see docs/archive/exec-plans/ports-and-adapters/phase-7-composition-root.md
  */
-import { ARTIFACT_EXPORT_PHASE_ID, InMemoryPluginRegistry, NoOpArtifactWriter, NoOpProgressReporter, generateRunId, isArtifactType, } from "./_vendor/ailf-core/index.js";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { ARTIFACT_EXPORT_PHASE_ID, DIAGNOSIS_CARD_GENERATORS, InMemoryPluginRegistry, NoOpArtifactWriter, NoOpProgressReporter, createDiagnosisRunner, createLLMClient, generateRunId, isArtifactType, modelId, } from "./_vendor/ailf-core/index.js";
+import { JudgmentAttributionSchema } from "./adapters/attribution/per-entry-attribution-writer.js";
 import { AccumulatingArtifactWriter } from "./artifact-capture/accumulating-artifact-writer.js";
 import { ApiGatewayArtifactWriter } from "./artifact-capture/api-gateway-artifact-writer.js";
 import { BatchingApiGatewayArtifactWriter } from "./artifact-capture/batching-api-gateway-artifact-writer.js";
@@ -96,10 +99,19 @@ export function createAppContext(config) {
     // LLM client (D0051) — wired when an API key is present. The grader path
     // does NOT consume this; D0051 defers grader migration as a follow-up.
     // Env mapping happens here so `createLLMClient` stays pure and testable.
-    const llmClient = createLLMClient(config, {
+    // D-01: factory hoisted to @sanity/ailf-core; adapter ctors injected here.
+    const llmAdapters = {
+        newAnthropicClient: (opts) => new AnthropicLLMClient(opts),
+        newOpenAIClient: (opts) => new OpenAILLMClient(opts),
+    };
+    const llmKeys = {
         anthropicApiKey: process.env.ANTHROPIC_API_KEY,
         openaiApiKey: process.env.OPENAI_API_KEY,
-    }, logger);
+    };
+    const llmClient = createLLMClient(config, llmKeys, {
+        logger,
+        adapters: llmAdapters,
+    });
     return {
         artifactWriter,
         cache,
@@ -117,44 +129,6 @@ export function createAppContext(config) {
         taskSource,
     };
 }
-/**
- * Select the LLMClient adapter based on `config.llmProvider` and the
- * supplied API keys. Returns `undefined` when no usable credential is
- * present — `AppContext.llmClient` stays unset and consumers handle that
- * explicitly.
- *
- * Adapters never read `process.env` themselves (per
- * `.claude/rules/typescript.md`); env mapping happens at the call site
- * (typically `createAppContext`).
- *
- * Exported for unit-test access; not part of the public package API.
- */
-export function createLLMClient(config, keys, logger) {
-    const explicit = config.llmProvider;
-    const anthropicKey = keys.anthropicApiKey;
-    const openaiKey = keys.openaiApiKey;
-    // Auto-select: prefer Anthropic when both are present (matches the
-    // current grader's default model in `config/models.ts`).
-    const provider = explicit ?? (anthropicKey ? "anthropic" : openaiKey ? "openai" : undefined);
-    if (!provider) {
-        logger.debug("LLM client: not wired — no Anthropic or OpenAI API key supplied");
-        return undefined;
-    }
-    if (provider === "anthropic") {
-        if (!anthropicKey) {
-            logger.warn('llmProvider="anthropic" but no Anthropic API key supplied — LLMClient not wired');
-            return undefined;
-        }
-        logger.debug("LLM client: AnthropicLLMClient");
-        return new AnthropicLLMClient({ apiKey: anthropicKey, logger });
-    }
-    if (!openaiKey) {
-        logger.warn('llmProvider="openai" but no OpenAI API key supplied — LLMClient not wired');
-        return undefined;
-    }
-    logger.debug("LLM client: OpenAILLMClient");
-    return new OpenAILLMClient({ apiKey: openaiKey, logger });
-}
 // ---------------------------------------------------------------------------
 // Sub-factories (extracted to keep createAppContext readable)
 // ---------------------------------------------------------------------------
@@ -541,3 +515,95 @@ export function createBorderlineConsensusRunner(opts) {
         thresholds: BORDERLINE_SEVERITY_THRESHOLDS,
     });
 }
+// ---------------------------------------------------------------------------
+// Diagnosis runner wiring (Plan 05-05 / D0048)
+// ---------------------------------------------------------------------------
+/**
+ * Returns the full 8-card `CardRegistry` backed by `DIAGNOSIS_CARD_GENERATORS`
+ * from `@sanity/ailf-core`. Exposed as a function (not a module-level const)
+ * so the composition root remains the single-seam factory and tests can assert
+ * the call site (AI-SPEC §3 Pitfall 1 — no module-scope mutables).
+ */
+export function buildDiagnosisRegistry() {
+    return DIAGNOSIS_CARD_GENERATORS;
+}
+/**
+ * Default local artifacts root (mirrors `createArtifactWriter` default above).
+ */
+const DIAGNOSIS_LOCAL_ARTIFACTS_DIR = ".ailf/results/captures";
+/**
+ * Load all per-entry attribution objects for a given `runId` from the local
+ * filesystem at `{artifactsDir}/runs/{runId}/attribution/*.json`.
+ *
+ * Reads every `.json` file in the run's `attribution/` directory, JSON-parses
+ * it, and Zod-validates each entry through `JudgmentAttributionSchema` (Phase-4
+ * canonical schema — D0045). Malformed entries are skipped with a warning.
+ *
+ * Returns an empty array when the directory does not exist (expected on runs
+ * without Phase-4 attribution data — the runner treats this as Landmine-11
+ * "no data" and both attribution cards return `status: "missing"`).
+ */
+async function loadAttributionsFromLocalFs(runId, artifactsDir, logger) {
+    const attrDir = path.join(artifactsDir, "runs", runId, "attribution");
+    let entries;
+    try {
+        entries = (await fs.readdir(attrDir)).filter((f) => f.endsWith(".json"));
+    }
+    catch {
+        // Directory missing — no attribution data for this run.
+        return [];
+    }
+    const results = [];
+    for (const filename of entries) {
+        const filePath = path.join(attrDir, filename);
+        let raw;
+        try {
+            const bytes = await fs.readFile(filePath, "utf8");
+            raw = JSON.parse(bytes);
+        }
+        catch (err) {
+            logger?.warn("loadAttributions: failed to read/parse attribution file", {
+                file: filePath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        const parsed = JudgmentAttributionSchema.safeParse(raw);
+        if (!parsed.success) {
+            logger?.warn("loadAttributions: attribution file failed schema validation", {
+                file: filePath,
+                errors: parsed.error.flatten(),
+            });
+            continue;
+        }
+        results.push(parsed.data);
+    }
+    return results;
+}
+/**
+ * Build a fully-wired `DiagnosisRunner` from an `AppContext`.
+ *
+ * Wires the full 8-card registry, `loadAttributions` bound to the local
+ * filesystem (Phase-4 per-entry attribution objects at
+ * `{artifactsDir}/runs/{runId}/attribution/*.json`), and no-op cache
+ * reader/writer (Plan-06 CLI command will wire the real cache seam).
+ *
+ * Plan-06 API/CLI consumers import this function from the composition root
+ * and pass `ctx` from `createAppContext(config)`.
+ */
+export function getDiagnosisRunner(ctx) {
+    const artifactsDir = ctx.config.artifactsDir ?? DIAGNOSIS_LOCAL_ARTIFACTS_DIR;
+    // No-op cache shims — Plan 06 wires the real cache.
+    const diagnosisReader = async (_path) => null;
+    const diagnosisWriter = async (_path, _diagnosis) => { };
+    return createDiagnosisRunner({
+        llm: ctx.llmClient,
+        model: modelId("anthropic:claude-opus-4-6"),
+        logger: ctx.logger,
+        progress: ctx.progress,
+        registry: buildDiagnosisRegistry(),
+        diagnosisReader,
+        diagnosisWriter,
+        loadAttributions: (runId) => loadAttributionsFromLocalFs(runId, artifactsDir, ctx.logger),
+    });
+}

package/dist/config/diagnosis-cards.ts

@@ -0,0 +1,318 @@
+/**
+ * diagnosis-cards.ts — Diagnosis eval matrix config.
+ *
+ * TS-first config (per .claude/rules/config.md) defining the 5 LLM card types
+ * × 3 first-class models eval matrix. Consumed by
+ * `scripts/generate-diagnosis-config.ts` to emit
+ * `promptfooconfig-diagnosis.yaml`. Never hand-edit the YAML — run
+ * `pnpm generate-configs` instead.
+ *
+ * Per AI-SPEC §5 and CONTEXT D-04 (path b: standalone generator entry point
+ * for the diagnosis config, additive — does not modify the existing literacy
+ * generate-configs pipeline).
+ *
+ * @see packages/eval/scripts/generate-diagnosis-config.ts — generator
+ * @see packages/eval/promptfooconfig-diagnosis.yaml — generated output
+ */
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/**
+ * A first-class model entry in the diagnosis eval matrix.
+ * Mirrors the shape of model entries in `config/models.ts`.
+ */
+export interface DiagnosisModelEntry {
+  /** Promptfoo provider string (e.g. "anthropic:messages:claude-opus-4-6") */
+  id: string
+  /** Human-readable label for reports */
+  label: string
+  /** Per-model config overrides (temperature, max_tokens, etc.) */
+  config?: Record<string, unknown>
+}
+
+/**
+ * The 5 LLM-driven card types under evaluation.
+ * Deterministic cards (area-summary, failure-mode-summary, no-issues) are
+ * tested via `fixture-matrix.test.ts` (vitest), not via the promptfoo matrix.
+ */
+export type LLMCardType =
+  | "top-recommendations"
+  | "weakest-area"
+  | "low-confidence-attribution"
+  | "doc-attribution-spotlight"
+  | "regression-vs-baseline"
+
+/**
+ * A single evaluation scenario: one fixture path × one expected outcome.
+ *
+ * The `fixturePath` is relative to `packages/eval/` so the promptfoo config
+ * can resolve it from any working directory. `expectedStatus` drives the
+ * pass/fail assertion in the generated YAML.
+ */
+export interface DiagnosisScenario {
+  /** Short slug used in promptfoo `description` fields */
+  name: string
+  /** Path to the Report JSON fixture, relative to `packages/eval/` */
+  fixturePath: string
+  /**
+   * Card type this scenario exercises. The eval matrix runs all LLM cards
+   * per scenario; this field annotates which card type is the primary focus
+   * for the rubric.
+   */
+  primaryCard: LLMCardType
+  /** Expected card status when all LLM calls succeed */
+  expectedStatus: "ready" | "degraded" | "missing"
+  /** Optional: path to canned LLM response for adversarial scenarios */
+  cannedResponsePath?: string
+  /**
+   * Optional: cardId to key the canned response against (for FakeLLMClient
+   * keyedResponses in vitest; mirrored in the promptfoo scenario description
+   * for documentation).
+   */
+  cannedCardId?: LLMCardType
+  /** Free-text note about what this scenario tests */
+  note?: string
+}
+
+/**
+ * Top-level diagnosis eval matrix config.
+ * Exported as the default export of this file (mirrors models.ts convention).
+ */
+export interface DiagnosisCardsConfig {
+  /** All LLM card evaluation scenarios */
+  scenarios: DiagnosisScenario[]
+  /** Models to run each scenario against */
+  models: DiagnosisModelEntry[]
+  /** Grader model for LLM-judge assertions */
+  grader: DiagnosisModelEntry
+  /** Eval budget in milliseconds (kill switch) */
+  evalBudgetMs: number
+  /** Max parallel API calls */
+  maxConcurrency: number
+  /** Default per-model config */
+  defaults: {
+    temperature: number
+    max_tokens: number
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+
+export function defineDiagnosisCards(
+  config: DiagnosisCardsConfig
+): DiagnosisCardsConfig {
+  return config
+}
+
+// ---------------------------------------------------------------------------
+// Config definition
+// ---------------------------------------------------------------------------
+
+const diagnosisCardsConfig: DiagnosisCardsConfig = defineDiagnosisCards({
+  // ── Models under evaluation ────────────────────────────────────────────────
+  models: [
+    {
+      id: "anthropic:messages:claude-opus-4-6",
+      label: "Claude Opus 4.6",
+      config: { temperature: 0.2, max_tokens: 4096 },
+    },
+    {
+      id: "anthropic:messages:claude-sonnet-4-6",
+      label: "Claude Sonnet 4.6",
+      config: { temperature: 0.2, max_tokens: 4096 },
+    },
+    {
+      id: "openai:chat:gpt-5.2",
+      label: "GPT 5.2",
+      config: { max_completion_tokens: 4096 },
+    },
+  ],
+
+  // ── Grader model ────────────────────────────────────────────────────────────
+  grader: {
+    id: "anthropic:messages:claude-opus-4-5-20251101",
+    label: "Claude Opus 4.5 (grader)",
+  },
+
+  // ── Eval budget ─────────────────────────────────────────────────────────────
+  evalBudgetMs: 3_600_000, // 60 min — full matrix across 3 models × 17 scenarios
+  maxConcurrency: 8, // conservative for diagnosis (longer prompts than literacy)
+
+  // ── Default config ──────────────────────────────────────────────────────────
+  defaults: {
+    temperature: 0.2,
+    max_tokens: 4096,
+  },
+
+  // ── Scenarios (17 logical fixtures) ─────────────────────────────────────────
+  scenarios: [
+    // ── Critical-path: top-recommendations ──────────────────────────────────
+    {
+      name: "healthy-top-recommendations",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/healthy-top-recommendations.json",
+      primaryCard: "top-recommendations",
+      expectedStatus: "ready",
+      note: "Healthy report (mean 91) — top-recommendations card should produce 2+ actionable suggestions with docSlug references from the manifest.",
+    },
+    {
+      name: "low-top-recommendations",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/low-top-recommendations.json",
+      primaryCard: "top-recommendations",
+      expectedStatus: "ready",
+      note: "Low-scoring report (mean 42) — top-recommendations card should produce high-priority suggestions addressing the dominant failure modes (outdated-docs, missing-docs).",
+    },
+
+    // ── Critical-path: weakest-area ──────────────────────────────────────────
+    {
+      name: "healthy-weakest-area",
+      fixturePath: "test-fixtures/diagnosis/reports/healthy-weakest-area.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "ready",
+      note: "Healthy report with clear weakest area (content-modeling at 82) — weakest-area card should identify the area and provide high-confidence analysis.",
+    },
+    {
+      name: "low-weakest-area",
+      fixturePath: "test-fixtures/diagnosis/reports/low-weakest-area.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "ready",
+      note: "Low-scoring report with clear weakest area (content-modeling at 28) — weakest-area card should identify the most critical area with multiple failure modes.",
+    },
+
+    // ── Critical-path: low-confidence-attribution ────────────────────────────
+    {
+      name: "healthy-low-confidence-attribution",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/healthy-low-confidence-attribution.json",
+      primaryCard: "low-confidence-attribution",
+      expectedStatus: "ready",
+      note: "Healthy report with small sample sizes (2-3 judgments per area) — low-confidence-attribution card should identify attribution uncertainty despite positive scores.",
+    },
+    {
+      name: "low-low-confidence-attribution",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/low-low-confidence-attribution.json",
+      primaryCard: "low-confidence-attribution",
+      expectedStatus: "ready",
+      note: "Low-scoring report with small sample sizes (2 judgments per area) — low-confidence-attribution card should flag both score quality and attribution uncertainty.",
+    },
+
+    // ── Critical-path: doc-attribution-spotlight ─────────────────────────────
+    {
+      name: "healthy-doc-attribution-spotlight",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/healthy-doc-attribution-spotlight.json",
+      primaryCard: "doc-attribution-spotlight",
+      expectedStatus: "ready",
+      note: "Healthy 5-area report — doc-attribution-spotlight card should identify the highest-impact document in the manifest.",
+    },
+    {
+      name: "low-doc-attribution-spotlight",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/low-doc-attribution-spotlight.json",
+      primaryCard: "doc-attribution-spotlight",
+      expectedStatus: "ready",
+      note: "Low-scoring 5-area report with multiple failure modes — doc-attribution-spotlight card should identify the most critical document.",
+    },
+
+    // ── Edge cases ───────────────────────────────────────────────────────────
+    {
+      name: "empty-report",
+      fixturePath: "test-fixtures/diagnosis/reports/empty.json",
+      primaryCard: "top-recommendations",
+      expectedStatus: "missing",
+      note: "Edge case (a): zero-area report — all LLM cards should emit status: missing (no data to reason about).",
+    },
+    {
+      name: "single-judgment-per-area",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/single-judgment-per-area.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "ready",
+      note: "Edge case (b): single-judgment sample size — weakest-area card should reflect low-confidence calibration (sampleSize: 1).",
+    },
+    {
+      name: "all-areas-tied",
+      fixturePath: "test-fixtures/diagnosis/reports/all-areas-tied.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "missing",
+      note: "Edge case (c): all areas scored identically (70) — weakest-area card should emit status: missing with reason: no-clear-weakest.",
+    },
+    {
+      name: "grader-major-mismatch-baseline",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/grader-major-mismatch-baseline.json",
+      primaryCard: "regression-vs-baseline",
+      expectedStatus: "missing",
+      note: "Edge case (d): grader-major-version mismatch — regression-vs-baseline should emit missing with reason: grader-major-version-mismatch. Run as pair with grader-major-mismatch-current.",
+    },
+    {
+      name: "grader-major-mismatch-current",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/grader-major-mismatch-current.json",
+      primaryCard: "regression-vs-baseline",
+      expectedStatus: "missing",
+      note: "Edge case (d) pair: current report with different graderModel — regression-vs-baseline mismatch guard triggers when paired with grader-major-mismatch-baseline.",
+    },
+    {
+      name: "near-deprecated-taxonomy",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/near-deprecated-taxonomy.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "ready",
+      note: "Edge case (e): report using unclassified failure mode (currently canonical but watch for taxonomy retirement). Zod refine() must accept canonical modes.",
+    },
+
+    // ── Adversarial canned responses ─────────────────────────────────────────
+    {
+      name: "adversarial-fabricated-delta",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/grader-major-mismatch-current.json",
+      primaryCard: "regression-vs-baseline",
+      expectedStatus: "degraded",
+      cannedResponsePath:
+        "test-fixtures/diagnosis/canned-responses/fabricated-delta-regression.json",
+      cannedCardId: "regression-vs-baseline",
+      note: "Adversarial: fabricated delta (AI-SPEC §1b failure-mode #1). LLM claims -7.3 delta; direction-sign refine triggers degraded card.",
+    },
+    {
+      name: "adversarial-improve-introduction",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/low-top-recommendations.json",
+      primaryCard: "top-recommendations",
+      expectedStatus: "degraded",
+      cannedResponsePath:
+        "test-fixtures/diagnosis/canned-responses/improve-introduction.json",
+      cannedCardId: "top-recommendations",
+      note: "Adversarial: generic anti-pattern recommendation (AI-SPEC §1b failure-mode #2). Actionability refine triggers degraded card.",
+    },
+    {
+      name: "adversarial-hallucinated-docslug",
+      fixturePath:
+        "test-fixtures/diagnosis/reports/low-top-recommendations.json",
+      primaryCard: "top-recommendations",
+      expectedStatus: "degraded",
+      cannedResponsePath:
+        "test-fixtures/diagnosis/canned-responses/hallucinated-docslug.json",
+      cannedCardId: "top-recommendations",
+      note: "Adversarial: hallucinated docSlug (AI-SPEC §1b failure-mode #3). Allow-list refine triggers degraded card.",
+    },
+    {
+      name: "adversarial-taxonomy-drift",
+      fixturePath: "test-fixtures/diagnosis/reports/low-weakest-area.json",
+      primaryCard: "weakest-area",
+      expectedStatus: "degraded",
+      cannedResponsePath:
+        "test-fixtures/diagnosis/canned-responses/taxonomy-drift.json",
+      cannedCardId: "weakest-area",
+      note: "Adversarial: taxonomy drift (AI-SPEC §1b failure-mode #4). Per-dimension failureMode refine triggers degraded card.",
+    },
+  ],
+})
+
+export default diagnosisCardsConfig

package/dist/config/models.ts

@@ -24,6 +24,18 @@ export default defineModels({
       // All literacy variants included by default (baseline, observed,
       // agentic-naive, agentic-optimized)
     },
+    {
+      // Phase 5 LLM card routing (D-07). AI-SPEC §4 routes 3 routine cards
+      // (top-recommendations, weakest-area, regression-vs-baseline) here.
+      // Pricing already in AnthropicLLMClient; baseline literacy variant only.
+      id: "anthropic:messages:claude-sonnet-4-6",
+      label: "Claude Sonnet 4.6",
+      config: { temperature: 0.2, max_tokens: 4096 },
+      modes: ["literacy"],
+      variants: {
+        literacy: ["baseline"],
+      },
+    },
 
     // ── Google ─────────────────────────────────────────────────
     // {

package/dist/grader/agent-harness.d.ts

@@ -1,14 +1,9 @@
 /**
- * Agent-harness failure modes — valid for the `agent-harness` dimension
- * family (process-quality, agent-output, tool-usage).
+ * Agent-harness failure modes — re-export shim (D-05).
  *
- * Phase 3 GRAD-03 (Plan 03-02). Agent-harness failures track how an agent
- * uses tools and handles multi-step processes; the v0 modes are tool-misuse,
- * chaotic-process (no plan), and missing-recovery (doesn't recover from
- * tool errors).
+ * Canonical data relocated to @sanity/ailf-core.
+ * Existing callers of this file continue to work unchanged.
  *
- * @see docs/design-docs/actionability-ladder/03-structured-grader-judgments.md
- *      §"Per-dimension failure-mode taxonomies" (lines 239-283).
+ * @see packages/core/src/grader/failure-modes/agent-harness.ts
  */
-export declare const AGENT_FAILURE_MODES: readonly ["tool-misuse", "chaotic-process", "missing-recovery"];
-export type AgentFailureMode = (typeof AGENT_FAILURE_MODES)[number];
+export { AGENT_FAILURE_MODES, type AgentFailureMode } from "../_vendor/ailf-core/index.d.ts";

package/dist/grader/agent-harness.js

@@ -1,17 +1,9 @@
 /**
- * Agent-harness failure modes — valid for the `agent-harness` dimension
- * family (process-quality, agent-output, tool-usage).
+ * Agent-harness failure modes — re-export shim (D-05).
  *
- * Phase 3 GRAD-03 (Plan 03-02). Agent-harness failures track how an agent
- * uses tools and handles multi-step processes; the v0 modes are tool-misuse,
- * chaotic-process (no plan), and missing-recovery (doesn't recover from
- * tool errors).
+ * Canonical data relocated to @sanity/ailf-core.
+ * Existing callers of this file continue to work unchanged.
  *
- * @see docs/design-docs/actionability-ladder/03-structured-grader-judgments.md
- *      §"Per-dimension failure-mode taxonomies" (lines 239-283).
+ * @see packages/core/src/grader/failure-modes/agent-harness.ts
  */
-export const AGENT_FAILURE_MODES = [
-    "tool-misuse", // assistant calls tools incorrectly or with wrong args
-    "chaotic-process", // assistant flails — undirected exploration, no plan
-    "missing-recovery", // assistant doesn't recover from a tool error
-];
+export { AGENT_FAILURE_MODES } from "../_vendor/ailf-core/index.js";

package/dist/grader/common.d.ts

@@ -1,17 +1,9 @@
 /**
- * Cross-cutting failure modes — valid for any dimension family.
+ * Cross-cutting failure modes — re-export shim (D-05).
  *
- * Phase 3 GRAD-03 (Plan 03-02). The four cross-cutting modes capture failures
- * that aren't tied to a specific dimension family: infrastructure failures,
- * model ceiling effects, false-floor (model already knew the answer; docs
- * added no value), and the low-confidence fallback. The per-dimension
- * taxonomies (literacy, MCP, knowledge-probe, agent-harness) extend this
- * cross-cutting list.
+ * Canonical data relocated to @sanity/ailf-core.
+ * Existing callers of this file continue to work unchanged.
  *
- * @see docs/design-docs/actionability-ladder/03-structured-grader-judgments.md
- *      §"Per-dimension failure-mode taxonomies" (lines 239-283 — the v0 lists)
- * @see docs/decisions/D0005-grader-model-separation.md — single grader model;
- *      taxonomies travel with the rubric prompt for reproducibility.
+ * @see packages/core/src/grader/failure-modes/common.ts
  */
-export declare const COMMON_FAILURE_MODES: readonly ["api-error", "model-limitation", "false-floor", "unclassified"];
-export type CommonFailureMode = (typeof COMMON_FAILURE_MODES)[number];
+export { COMMON_FAILURE_MODES, type CommonFailureMode } from "../_vendor/ailf-core/index.d.ts";

package/dist/grader/common.js

@@ -1,21 +1,9 @@
 /**
- * Cross-cutting failure modes — valid for any dimension family.
+ * Cross-cutting failure modes — re-export shim (D-05).
  *
- * Phase 3 GRAD-03 (Plan 03-02). The four cross-cutting modes capture failures
- * that aren't tied to a specific dimension family: infrastructure failures,
- * model ceiling effects, false-floor (model already knew the answer; docs
- * added no value), and the low-confidence fallback. The per-dimension
- * taxonomies (literacy, MCP, knowledge-probe, agent-harness) extend this
- * cross-cutting list.
+ * Canonical data relocated to @sanity/ailf-core.
+ * Existing callers of this file continue to work unchanged.
  *
- * @see docs/design-docs/actionability-ladder/03-structured-grader-judgments.md
- *      §"Per-dimension failure-mode taxonomies" (lines 239-283 — the v0 lists)
- * @see docs/decisions/D0005-grader-model-separation.md — single grader model;
- *      taxonomies travel with the rubric prompt for reproducibility.
+ * @see packages/core/src/grader/failure-modes/common.ts
  */
-export const COMMON_FAILURE_MODES = [
-    "api-error", // infrastructure failure, not a docs problem
-    "model-limitation", // high ceiling, model can't reach it
-    "false-floor", // model already knew the answer; docs added no value
-    "unclassified", // grader could not pick a mode (low-confidence fallback)
-];
+export { COMMON_FAILURE_MODES } from "../_vendor/ailf-core/index.js";

package/dist/grader/index.d.ts

@@ -1,38 +1,24 @@
 /**
  * Per-dimension failure-mode taxonomy barrel.
  *
+ * D-05: taxonomy data relocated to @sanity/ailf-core so card files in
+ * packages/core/src/services/diagnosis/cards/ can import without violating
+ * the core→eval import direction rule.
+ *
+ * This file is now a re-export shim — all behavior lives in
+ * packages/core/src/grader/failure-modes/. Existing eval-side callers
+ * (rubrics.ts, rubric-resolution.ts, calibration.test.ts) continue to
+ * work with zero source changes.
+ *
  * Named re-exports only (W0124 — never `export *`).
  *
  * Consumers:
- * - `packages/eval/config/rubrics.ts` — calls `failureModesForDimension()` to
- *   stamp a per-template legal-mode list onto every rubric template entry.
- * - `packages/eval/src/pipeline/compiler/rubric-resolution.ts` — reads
- *   `template.failureModes` at prompt-assembly time and announces the legal
- *   modes to the grader before the structured-shape footer (Plan 03-01).
- * - `packages/eval/src/grader/__tests__/calibration.test.ts` — fixture-driven
- *   ≥90% non-`unclassified` static calibration check (ROADMAP success
- *   criterion 1).
+ * - `packages/eval/config/rubrics.ts` — calls `failureModesForDimension()`
+ * - `packages/eval/src/pipeline/compiler/rubric-resolution.ts`
+ * - `packages/eval/src/grader/__tests__/calibration.test.ts`
  *
+ * @see packages/core/src/grader/failure-modes/index.ts — canonical location
  * @see docs/design-docs/actionability-ladder/03-structured-grader-judgments.md
- *      §"Per-dimension failure-mode taxonomies" (lines 239-283).
- * @see docs/decisions/D0005-grader-model-separation.md — single grader model;
- *      taxonomies travel with the rubric prompt for reproducibility.
- */
-export { COMMON_FAILURE_MODES, type CommonFailureMode } from "./common.js";
-export { LITERACY_FAILURE_MODES, type LiteracyFailureMode } from "./literacy.js";
-export { MCP_FAILURE_MODES, type MCPFailureMode } from "./mcp.js";
-export { KP_FAILURE_MODES, type KPFailureMode } from "./knowledge-probe.js";
-export { AGENT_FAILURE_MODES, type AgentFailureMode } from "./agent-harness.js";
-/**
- * Return the legal failure-mode list for a given rubric dimension.
- *
- * Accepts both family-level keys (`mcp-behavior`, `knowledge-probe`,
- * `agent-harness`) and the per-template `dimension` strings used in
- * `config/rubrics.ts` (`task-completion`, `input-validation`,
- * `factual-correctness`, `process-quality`, …). The cross-cutting
- * `COMMON_FAILURE_MODES` is always included.
- *
- * Unknown dimensions fall through to `COMMON_FAILURE_MODES` only — safe
- * default, the grader can still pick `unclassified`.
+ * @see docs/decisions/D0005-grader-model-separation.md
  */
-export declare function failureModesForDimension(dimension: string): readonly string[];
+export { AGENT_FAILURE_MODES, CANONICAL_DIMENSIONS, COMMON_FAILURE_MODES, KP_FAILURE_MODES, LITERACY_FAILURE_MODES, MCP_FAILURE_MODES, failureModesForDimension, isCanonicalFailureMode, type AgentFailureMode, type CommonFailureMode, type KPFailureMode, type LiteracyFailureMode, type MCPFailureMode, } from "../_vendor/ailf-core/index.d.ts";