@sanity/ailf 6.0.0 → 6.1.0

package/dist/adapters/task-sources/repo-schemas.js

@@ -646,6 +646,15 @@ const OwnerConfigSchema = z
     individual: z.string().min(1).optional(),
 })
     .optional();
+/**
+ * Post-run diagnosis summary policy (Phase 6 / DIAG-06).
+ * Sits in the W0077 Phase-6a auto-load pathway.
+ */
+const SummaryConfigSchema = z
+    .object({
+    onRun: z.enum(["auto", "always", "never"]).optional(),
+})
+    .optional();
 /**
  * Agentic-mode configuration (W0077 Phase 6f). Replaces the retired
  * `--header` and `--allowed-origin` CLI flags. `headers` is a key/value
@@ -694,6 +703,7 @@ export const RepoConfigSchema = z.object({
     owner: OwnerConfigSchema,
     agentic: AgenticConfigSchema,
     artifacts: ArtifactsConfigSchema,
+    summary: SummaryConfigSchema,
     taskSource: TaskSourceConfigSchema,
     triggers: z
         .object({

package/dist/commands/interpret.d.ts

@@ -16,7 +16,7 @@
  * @see .planning/phases/05-diagnosis-engine-cli-llm-cards/05-AI-SPEC.md §6
  */
 import { Command } from "commander";
-import type { DiagnosisRunner, VersionedInputs } from "../_vendor/ailf-core/index.d.ts";
+import { type DiagnosisCard, type DiagnosisRunner, type VersionedInputs } from "../_vendor/ailf-core/index.d.ts";
 interface MinimalReportStore {
     read(id: string): Promise<unknown | null>;
     latest(): Promise<unknown | null>;
@@ -39,6 +39,26 @@ export interface InterpretCommandOptions {
      */
     readonly versionsFromReport?: (report: unknown) => VersionedInputs;
 }
+/**
+ * Visual status markers — locked visual contract per plan Test 7:
+ * ready: "✓", degraded: "⚠", missing: "—"
+ *
+ * Exported so Plan 06-04's post-run hook imports the SAME object and
+ * D6-04's "single formatter, single visual contract" is physically
+ * enforced — no copy/paste drift possible.
+ */
+export declare const STATUS_ICONS: Record<DiagnosisCard["status"], string>;
+/**
+ * Format a single card as a one-line summary string.
+ *
+ * Format: `<icon> <cardType>: <summary>`
+ * Per AI-SPEC §6: distinct icons for ready / degraded / missing.
+ *
+ * Exported so Plan 06-04's post-run hook imports the SAME function and
+ * D6-04's "single formatter, single visual contract" is physically
+ * enforced — no copy/paste drift possible.
+ */
+export declare function formatCardSummaryLine(card: DiagnosisCard): string;
 /**
  * Create the `ailf interpret <reportId>` Commander command.
  *

package/dist/commands/interpret.js

@@ -18,6 +18,7 @@
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 import { Command } from "commander";
+import { CARD_REGISTRY_VERSION, diagnosisVersion, } from "../_vendor/ailf-core/index.js";
 import { addOutputDirOption } from "./shared/options.js";
 import { resolveOutputDir } from "./shared/resolve-output-dir.js";
 // ---------------------------------------------------------------------------
@@ -31,8 +32,12 @@ const ROOT = resolve(__dirname, "..", "..");
 /**
  * Visual status markers — locked visual contract per plan Test 7:
  * ready: "✓", degraded: "⚠", missing: "—"
+ *
+ * Exported so Plan 06-04's post-run hook imports the SAME object and
+ * D6-04's "single formatter, single visual contract" is physically
+ * enforced — no copy/paste drift possible.
  */
-const STATUS_ICONS = {
+export const STATUS_ICONS = {
     ready: "✓",
     degraded: "⚠",
     missing: "—",
@@ -52,8 +57,12 @@ function getCardSummaryText(card) {
  *
  * Format: `<icon> <cardType>: <summary>`
  * Per AI-SPEC §6: distinct icons for ready / degraded / missing.
+ *
+ * Exported so Plan 06-04's post-run hook imports the SAME function and
+ * D6-04's "single formatter, single visual contract" is physically
+ * enforced — no copy/paste drift possible.
  */
-function formatCardSummaryLine(card) {
+export function formatCardSummaryLine(card) {
     const icon = STATUS_ICONS[card.status];
     const text = getCardSummaryText(card);
     return `${icon} ${card.cardType}: ${text}`;
@@ -82,10 +91,10 @@ function defaultVersionsFromReport(report) {
             : "unknown",
         diagnosisVersion: typeof versions?.diagnosisVersion === "string"
             ? versions.diagnosisVersion
-            : "0.1.0",
+            : diagnosisVersion,
         cardVersion: typeof versions?.cardVersion === "string"
             ? versions.cardVersion
-            : "0.1.0",
+            : CARD_REGISTRY_VERSION,
     };
 }
 // ---------------------------------------------------------------------------

package/dist/commands/pipeline-action.d.ts

@@ -12,6 +12,7 @@
  */
 import { type ImpactSummary } from "../pipeline/reverse-mapping.js";
 import type { DebugOptions, EvalMode } from "../pipeline/types.js";
+import { type Diagnosis, type ReportStorePort, type SynthesisCostTelemetry } from "../_vendor/ailf-core/index.d.ts";
 import type { PipelineCliOptions } from "./run.js";
 export interface ResolvedOptions {
     allowedOriginArgs: string[];
@@ -63,6 +64,12 @@ export interface ResolvedOptions {
     studioOriginOverride?: string;
     remote: boolean;
     repoTasksPath?: string;
+    /** Phase 6 / DIAG-06: post-run diagnosis summary policy. Precedence
+     * resolution (CLI flag > env > config > auto) lives in
+     * shouldRunPostSummary() — this field carries only the config-file
+     * signal so the helper has a single typed input.
+     */
+    summaryOnRun?: "auto" | "always" | "never";
     taskOption?: string;
     tagOption?: string[];
     taskSourceType?: "content-lake" | "repo";
@@ -88,6 +95,43 @@ export interface ResolvedOptions {
  * Exported so the plan builder can call it independently.
  */
 export declare function computeResolvedOptions(opts: PipelineCliOptions): ResolvedOptions;
+/**
+ * Determine whether the post-run diagnosis summary hook should fire.
+ *
+ * 4-level precedence chain (D6-20):
+ *   Level 1 — CLI flag (absolute): if `cliOpts.summary` is boolean, use it.
+ *   Level 2 — AILF_INTERPRET_ON_RUN env var (absolute): strict "1"/"0" parse;
+ *             anything else falls through (T-06-11 spoofing mitigation).
+ *   Level 3 — config `summary.onRun` (absolute): "always" → true; "never" → false;
+ *             "auto" or absent falls through to level 4.
+ *   Level 4 — default auto: TTY && !CI (SC1 default-off in CI).
+ */
+export declare function shouldRunPostSummary(cliOpts: PipelineCliOptions, resolvedOnRun: "auto" | "always" | "never" | undefined): boolean;
+export declare function buildSynthesisTelemetry(diagnosis: Diagnosis): SynthesisCostTelemetry;
+/**
+ * Run post-pipeline hooks after the pipeline completes.
+ *
+ * Fires after orchestratePipeline() + writePipelineResult() (D6-02).
+ * Hook failure prints to stderr but does NOT change exit code (D6-03).
+ * CI default-off: fires only when shouldRunPostSummary returns true (D6-20).
+ *
+ * @param ctx - App context (composition root wiring)
+ * @param result - Pipeline result (includes reportId when published)
+ * @param args - Hook options (cliOpts, summaryOnRun from config, optional runnerFactory for tests)
+ */
+export declare function runPostPipelineHooks(ctx: {
+    reportStore?: ReportStorePort;
+}, result: {
+    success: boolean;
+    reportId?: string;
+}, args: {
+    cliOpts: PipelineCliOptions;
+    summaryOnRun?: "auto" | "always" | "never";
+    /** Override runner factory for tests — avoids vi.mock of composition root */
+    runnerFactory?: (ctx: unknown) => {
+        run(opts: unknown): Promise<Diagnosis>;
+    };
+}): Promise<void>;
 /**
  * Execute the evaluation pipeline.
  *

package/dist/commands/pipeline-action.js

@@ -20,9 +20,13 @@ import { buildAppContext, parseArtifactUploadEnv, } from "../orchestration/build
 import { buildStepSequence } from "../orchestration/build-step-sequence.js";
 import { orchestratePipeline } from "../orchestration/pipeline-orchestrator.js";
 import { load } from "js-yaml";
-import { PLACEHOLDER_OWNER_TEAM } from "../_vendor/ailf-core/index.js";
+import { PLACEHOLDER_OWNER_TEAM, } from "../_vendor/ailf-core/index.js";
 import { parseRepoConfig, } from "../adapters/task-sources/repo-schemas.js";
 import { getCallerCwd, resolveOutputDir } from "./shared/resolve-output-dir.js";
+// Phase 6 / DIAG-06 — single formatter, single visual contract (D6-04).
+// Import statically so bundlers and type-checkers can verify the export
+// exists at build time rather than deferring to runtime dynamic import.
+import { formatCardSummaryLine } from "./interpret.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = resolve(__dirname, "..", "..");
 // ---------------------------------------------------------------------------
@@ -250,6 +254,10 @@ export function computeResolvedOptions(opts) {
     const graderReplications = repoConfig?.execution?.graderReplications;
     const borderlineReplications = repoConfig?.execution?.borderlineReplications;
     const gapAnalysisEnabled = repoConfig?.execution?.gapAnalysis ?? true;
+    // Phase 6 / DIAG-06 — post-run diagnosis summary policy from .ailf/config.yaml.
+    // Precedence resolution (CLI flag > env > config > auto) lives in
+    // shouldRunPostSummary(); this only carries the config-file signal.
+    const summaryOnRun = repoConfig?.summary?.onRun;
     // Grader context policy. Cascade: env var > .ailf/config.yaml > unset
     // (defaults to rubric-only at the EvalConfig boundary). The env var is the
     // operational lever for one-shot comparison runs without editing the config file.
@@ -348,6 +356,7 @@ export function computeResolvedOptions(opts) {
             undefined,
         purposeOption: opts.purpose?.trim() || undefined,
         labelOptions: opts.label ?? [],
+        summaryOnRun,
     };
 }
 const PUBLISH_AUTO_VALUES = ["always", "full-runs", "never"];
@@ -373,6 +382,179 @@ function resolvePublishAuto(repoValue) {
     }
     return "full-runs";
 }
+// ---------------------------------------------------------------------------
+// Phase 6 / DIAG-06 — post-run diagnosis summary helpers
+// ---------------------------------------------------------------------------
+/**
+ * Determine whether the post-run diagnosis summary hook should fire.
+ *
+ * 4-level precedence chain (D6-20):
+ *   Level 1 — CLI flag (absolute): if `cliOpts.summary` is boolean, use it.
+ *   Level 2 — AILF_INTERPRET_ON_RUN env var (absolute): strict "1"/"0" parse;
+ *             anything else falls through (T-06-11 spoofing mitigation).
+ *   Level 3 — config `summary.onRun` (absolute): "always" → true; "never" → false;
+ *             "auto" or absent falls through to level 4.
+ *   Level 4 — default auto: TTY && !CI (SC1 default-off in CI).
+ */
+export function shouldRunPostSummary(cliOpts, resolvedOnRun) {
+    // Level 1: CLI flag wins absolutely
+    if (cliOpts.summary === true)
+        return true;
+    if (cliOpts.summary === false)
+        return false;
+    // Level 2: AILF_INTERPRET_ON_RUN env var (strict parse)
+    const envVal = process.env.AILF_INTERPRET_ON_RUN;
+    if (envVal === "1")
+        return true;
+    if (envVal === "0")
+        return false;
+    // Anything else (garbage, unset) falls through
+    // Level 3: config summary.onRun
+    if (resolvedOnRun === "always")
+        return true;
+    if (resolvedOnRun === "never")
+        return false;
+    // "auto" or undefined falls through
+    // Level 4: default auto — fire only when stdout is interactive and not in CI
+    return Boolean(process.stdout.isTTY) && process.env.CI !== "true";
+}
+/**
+ * Build a SynthesisCostTelemetry payload from a completed Diagnosis.
+ *
+ * Aggregates:
+ *   - cost: sum of meta.cost across all cards (undefined treated as 0)
+ *   - parseFailureCount: cards where status==="degraded" (parse failures)
+ *   - parseFailureRate: parseFailureCount / total-cards (max 8 per D6-09)
+ *   - perCard: per-card row with safe-extracted structured metadata
+ *
+ * Deliberately does NOT read card.body — only structured meta fields are
+ * persisted (T-06-14 PII guard per threat model).
+ */
+// D6-09: denominator is always the fixed card-registry size, not cards.length.
+// Using cards.length would allow parseFailureRate > 1.0 when the registry is
+// a subset (e.g. test registries), violating the SynthesisCostTelemetrySchema
+// min(0).max(1) constraint. Single edit point if the registry ever grows.
+const CARD_REGISTRY_SIZE = 8;
+export function buildSynthesisTelemetry(diagnosis) {
+    const cards = diagnosis.cards;
+    let totalCost = 0;
+    let parseFailureCount = 0;
+    const perCard = cards.map((card) => {
+        // "missing" cards have no `meta` — narrow with status guard
+        const meta = card.status !== "missing" ? card.meta : undefined;
+        const cost = meta?.cost ?? 0;
+        totalCost += cost;
+        // Parse failures produce status="degraded" (not "missing") in the current
+        // runner (diagnosis-runner.ts). A "missing" card is absence, not failure.
+        // If a future code path can produce status="missing" from a parse failure,
+        // this line must be updated and the parseFailed contract re-evaluated.
+        const parseFailed = card.status === "degraded";
+        if (parseFailed)
+            parseFailureCount++;
+        const row = {
+            cardType: card.cardType,
+            parseFailed,
+            cardVersion: meta?.cardVersion ?? "unknown",
+            generatedAt: meta?.generatedAt ?? new Date().toISOString(),
+        };
+        if (cost > 0)
+            row.cost = cost;
+        if (meta?.latencyMs !== undefined)
+            row.latencyMs = meta.latencyMs;
+        if (meta?.tokenUsage?.input !== undefined)
+            row.tokenInput = meta.tokenUsage.input;
+        if (meta?.tokenUsage?.output !== undefined)
+            row.tokenOutput = meta.tokenUsage.output;
+        return row;
+    });
+    return {
+        cost: totalCost,
+        parseFailureCount,
+        parseFailureRate: parseFailureCount / CARD_REGISTRY_SIZE,
+        perCard,
+    };
+}
+/**
+ * Run post-pipeline hooks after the pipeline completes.
+ *
+ * Fires after orchestratePipeline() + writePipelineResult() (D6-02).
+ * Hook failure prints to stderr but does NOT change exit code (D6-03).
+ * CI default-off: fires only when shouldRunPostSummary returns true (D6-20).
+ *
+ * @param ctx - App context (composition root wiring)
+ * @param result - Pipeline result (includes reportId when published)
+ * @param args - Hook options (cliOpts, summaryOnRun from config, optional runnerFactory for tests)
+ */
+export async function runPostPipelineHooks(ctx, result, args) {
+    if (!shouldRunPostSummary(args.cliOpts, args.summaryOnRun))
+        return;
+    if (!result.reportId) {
+        process.stderr.write("ℹ️ No report published — skipping post-summary.\n");
+        return;
+    }
+    const reportId = result.reportId;
+    try {
+        // Build the runner — use injected factory (tests) or composition root (production)
+        let runner;
+        if (args.runnerFactory) {
+            runner = args.runnerFactory(ctx);
+        }
+        else {
+            const { getDiagnosisRunner } = await import("../composition-root.js");
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            runner = getDiagnosisRunner(ctx);
+        }
+        // Read the stored report — needed by the runner for version metadata
+        const report = await ctx.reportStore?.read(reportId);
+        if (!report) {
+            process.stderr.write(`ℹ️ Report not found: ${reportId} — skipping post-summary.\n`);
+            return;
+        }
+        // Derive version metadata from the stored report (same approach as interpret.ts)
+        const rec = report;
+        const summary = rec.summary;
+        const versions = summary?.versions;
+        const versionedInputs = {
+            graderJudgmentsVersion: typeof versions?.graderJudgmentsVersion === "string"
+                ? versions.graderJudgmentsVersion
+                : "unknown",
+            ensembleVersion: typeof versions?.ensembleVersion === "string"
+                ? versions.ensembleVersion
+                : "unknown",
+            diagnosisVersion: typeof versions?.diagnosisVersion === "string"
+                ? versions.diagnosisVersion
+                : "unknown",
+            cardVersion: typeof versions?.cardVersion === "string"
+                ? versions.cardVersion
+                : "unknown",
+        };
+        // Run the diagnosis
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const diagnosis = await runner.run({
+            report: report,
+            versions: versionedInputs,
+            refresh: false,
+        });
+        // Print per-card summary lines to stdout (D6-04 single formatter)
+        for (const card of diagnosis.cards) {
+            process.stdout.write(`${formatCardSummaryLine(card)}\n`);
+        }
+        // Build and write synthesis telemetry back to the report doc (D6-08)
+        // patchSynthesis is now part of ReportStorePort (CR-01) — guard on store
+        // presence only; absent store means no report store is configured (expected).
+        if (ctx.reportStore) {
+            const telemetry = buildSynthesisTelemetry(diagnosis);
+            await ctx.reportStore.patchSynthesis(reportId, telemetry);
+        }
+        else {
+            process.stderr.write("ℹ️ No reportStore configured — synthesis telemetry not written to Sanity.\n");
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`⚠️ Diagnosis failed: ${msg}. Run \`ailf interpret ${reportId}\` to retry.\n`);
+    }
+}
 /** Resolve and validate the --task-source flag value. */
 function resolveTaskSourceType(raw) {
     if (!raw || raw === "content-lake")
@@ -471,6 +653,11 @@ export async function executePipeline(cliOpts) {
         const steps = buildStepSequence(ctx, pipelineStart);
         const result = await orchestratePipeline(ctx, steps);
         writePipelineResult(result, config.outputDir);
+        // Phase 6 / DIAG-06: post-run hook fires after artifacts are written (D6-02)
+        await runPostPipelineHooks(ctx, result, {
+            cliOpts,
+            summaryOnRun: config.summaryOnRun,
+        });
         process.exit(result.success ? 0 : 1);
     }
     const o = resolveOptions(cliOpts);
@@ -510,6 +697,11 @@ export async function executePipeline(cliOpts) {
     const steps = buildStepSequence(ctx, pipelineStart);
     const result = await orchestratePipeline(ctx, steps);
     writePipelineResult(result, o.outputDir);
+    // Phase 6 / DIAG-06: post-run hook fires after artifacts are written (D6-02)
+    await runPostPipelineHooks(ctx, result, {
+        cliOpts,
+        summaryOnRun: o.summaryOnRun,
+    });
     process.exit(result.success ? 0 : 1);
 }
 // ---------------------------------------------------------------------------

package/dist/commands/run.d.ts

@@ -47,6 +47,8 @@ export interface PipelineCliOptions {
     publish?: boolean;
     publishTag?: string;
     remoteCache?: boolean;
+    /** Phase 6 / DIAG-06: post-run diagnosis summary toggle. Undefined when neither flag is passed. */
+    summary?: boolean;
     sanityDocument: string[];
     sanityPerspective?: string;
     search?: string;

package/dist/commands/run.js

@@ -43,6 +43,8 @@ export function createRunCommand() {
         .option("-p, --publish", "Write report to Sanity + fan out to sinks (auto-enabled for full runs when report store is configured)")
         .option("--no-publish", "Suppress auto-publishing")
         .option("--publish-tag <tag>", "Label for published report")
+        .option("--summary", "Force post-run diagnosis summary (overrides config and CI default-off)")
+        .option("--no-summary", "Suppress post-run diagnosis summary")
         .option("--config <path>", "Load pipeline config from a TS/JS/YAML/JSON file (overrides most CLI flags)")
         .option("-o, --output <path>", "Write PR comment markdown to file")
         .option("--promptfoo-url <url>", "Promptfoo share URL for report")

package/dist/orchestration/pipeline-orchestrator.js

@@ -275,6 +275,9 @@ export async function orchestratePipeline(ctx, steps) {
         belowCritical: state.belowCritical,
         durationMs,
         promptfooUrls: state.promptfooUrls,
+        // Phase 6 / DIAG-06 — thread reportId from state so the post-run hook in
+        // pipeline-action.ts can target the published Content Lake document.
+        reportId: state.reportId,
         steps: results,
         success: true,
         testSummary: state.testSummary,

package/dist/report-store.d.ts

@@ -15,6 +15,7 @@
  * @see docs/design-docs/report-store/domain-model.md
  */
 import type { SanityClient } from "@sanity/client";
+import type { SynthesisCostTelemetry } from "./_vendor/ailf-core/index.d.ts";
 import type { ComparisonReport, ISOTimestamp, LineageQuery, Report, ReportId, ReportProvenance, ScoreSummary } from "./pipeline/types.js";
 /**
  * Result of an auto-comparison, bundling the ComparisonReport with the
@@ -89,6 +90,22 @@ export declare class ReportStore {
      * @see docs/design-docs/report-store/architecture.md — Auto-comparison
      */
     findComparableBaseline(query: LineageQuery): Promise<null | Report>;
+    /**
+     * Fetch the most recent report from the Content Lake.
+     *
+     * Mirrors the API gateway's `ReportStoreApi.latest()` signature
+     * (`packages/api/src/lib/sanity.ts`). Used by `ailf interpret latest`
+     * when no explicit report ID is supplied.
+     *
+     * @param query Optional narrowing by `mode` and/or `source.name`.
+     * @returns The most recent matching report, or null if none exist
+     *   or on API failure. Schema-validation errors are advisory (logged
+     *   and null-returned) per the same rationale as `findByFingerprint`.
+     */
+    latest(query?: {
+        mode?: string;
+        source?: string;
+    }): Promise<null | Report>;
     /**
      * Read a report by its ID.
      *
@@ -108,6 +125,15 @@ export declare class ReportStore {
      *   runtime schema gate. Schema drift is a bug, not an outage.
      */
     write(report: Report): Promise<null | ReportId>;
+    /**
+     * Patch synthesis telemetry onto a published report (Phase 6 / DIAG-06).
+     * Non-fatal on Sanity failure — the on-disk reportSnapshot artifact
+     * remains the source of truth. Mirrors `write()` (L379–411) for
+     * error handling.
+     *
+     * Document _id is `report-${reportId}` (see `toSanityReportDoc` L559).
+     */
+    patchSynthesis(reportId: ReportId, telemetry: SynthesisCostTelemetry): Promise<void>;
     /**
      * Query error arrays from the last N reports for chronic failure detection.
      *

package/dist/report-store.js

@@ -207,6 +207,50 @@ export class ReportStore {
             return null;
         }
     }
+    /**
+     * Fetch the most recent report from the Content Lake.
+     *
+     * Mirrors the API gateway's `ReportStoreApi.latest()` signature
+     * (`packages/api/src/lib/sanity.ts`). Used by `ailf interpret latest`
+     * when no explicit report ID is supplied.
+     *
+     * @param query Optional narrowing by `mode` and/or `source.name`.
+     * @returns The most recent matching report, or null if none exist
+     *   or on API failure. Schema-validation errors are advisory (logged
+     *   and null-returned) per the same rationale as `findByFingerprint`.
+     */
+    async latest(query) {
+        try {
+            let groq = `*[_type == $type`;
+            const params = { type: REPORT_TYPE };
+            if (query?.mode) {
+                groq += ` && provenance.mode == $mode`;
+                params.mode = query.mode;
+            }
+            if (query?.source) {
+                groq += ` && provenance.source.name == $source`;
+                params.source = query.source;
+            }
+            groq += `] | order(completedAt desc) [0]`;
+            const doc = await this.client.fetch(groq, params);
+            return doc ? toReport(doc) : null;
+        }
+        catch (error) {
+            // Advisory lookup — a malformed prior doc must not break a read-only
+            // CLI invocation. Log and return null so the caller surfaces a
+            // user-friendly "no report found" error instead of a Zod stack trace.
+            if (error instanceof ReportSchemaValidationError) {
+                logAdvisoryQuerySchemaFailure({
+                    query: "latest",
+                    context: { mode: query?.mode, sourceName: query?.source },
+                    error,
+                });
+                return null;
+            }
+            console.warn(`  ⚠️  Failed to fetch latest report from Sanity: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+    }
     /**
      * Read a report by its ID.
      *
@@ -264,6 +308,25 @@ export class ReportStore {
             return null;
         }
     }
+    /**
+     * Patch synthesis telemetry onto a published report (Phase 6 / DIAG-06).
+     * Non-fatal on Sanity failure — the on-disk reportSnapshot artifact
+     * remains the source of truth. Mirrors `write()` (L379–411) for
+     * error handling.
+     *
+     * Document _id is `report-${reportId}` (see `toSanityReportDoc` L559).
+     */
+    async patchSynthesis(reportId, telemetry) {
+        try {
+            await this.client
+                .patch(`report-${reportId}`)
+                .set({ "summary.synthesis": { diagnosis: telemetry } })
+                .commit();
+        }
+        catch (error) {
+            console.warn(`  ⚠️  Failed to patch synthesis telemetry on report ${reportId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     /**
      * Query error arrays from the last N reports for chronic failure detection.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/ailf",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "private": false,
   "publishConfig": {
     "access": "public"