agent-inspect 6.9.0 → 6.11.0

package/packages/cli/dist/index.mjs

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, enrichSessionRunRecord, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, extractMetadata, filterTraces, truncateName, getTraceFilePath, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, openTrace, TraceReadError, filterMetasBySessionScope, runTraceChecks, aggregateSessionCheckResults, createBaselineRegressionRule, resolveBundleRunIds, aggregateBundleSafeStatus, bundleFailsOnSafety, bundleRunAssetRelativePath, buildPlaceholderArtifact, buildBundleMetadata, buildBundleSummaryMarkdown, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, resolveSuiteTemplate, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, Redactor, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, normalizeBundleOutputPath, sanitizeBundleRunId, defaultBundleOutputPath, assertBundlePathContained, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, escapeMarkdown, escapeHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, resolveRedactionProfile, applyProfileMetadataCaps, flattenTree, safeString, compactAttributes, stableJson, truncateStringForProfile } from './chunk-WQ5XMFH2.mjs';
+import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, resolveBundleRunIds, getTraceFilePath, openTrace, sha256Hex, collectTraceSchemaVersions, aggregateBundleSafeStatus, bundleFailsOnSafety, bundleRunAssetRelativePath, buildPlaceholderArtifact, EVIDENCE_HTML_FILENAME, EVIDENCE_MANIFEST_FILENAME, buildBundleMetadata, buildBundleSummaryMarkdown, buildEvidenceHtmlShell, buildEvidenceProvenanceViewHtml, EVIDENCE_FORMAT_VERSION, inferEvidenceFileRole, buildEvidenceSafetyViewHtml, buildEvidenceDiffViewHtml, buildEvidenceCircuitViewHtml, buildEvidenceOutcomesViewHtml, buildEvidenceContractsViewHtml, buildEvidenceToolsLlmViewHtml, buildEvidenceCausalFailureViewHtml, buildEvidenceTimelineViewHtml, buildEvidenceTreeViewHtml, buildEvidenceManifest, serializeEvidenceManifest, buildZipArchive, assertBundlePathContained, enrichSessionRunRecord, normalizeBundleOutputPath, sanitizeBundleRunId, defaultBundleOutputPath, runTraceChecks, assertEvidenceRelativePath, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, TraceReadError, resolveRedactionProfile, applyProfileMetadataCaps, Redactor, flattenTree, escapeHtml, safeString, compactAttributes, stableJson, escapeMarkdown, truncateStringForProfile, extractMetadata, filterTraces, truncateName, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, filterMetasBySessionScope, aggregateSessionCheckResults, createBaselineRegressionRule, buildEvidenceCiPackage, verifyEvidenceDirectory, diffTraceEvents, renderRunDiff, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, resolveSuiteTemplate, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, diffRuns, manualTraceEventsToComparableRun } from './chunk-XTAA733P.mjs';
 import { realpathSync, constants as constants$1, existsSync, readFileSync } from 'fs';
-import path14 from 'path';
+import path16 from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { Command, Option } from 'commander';
-import { unlink, stat, mkdir, writeFile, appendFile, readFile, rm, access, open, readdir, constants } from 'fs/promises';
+import { readFile, stat, mkdir, writeFile, unlink, appendFile, rm, access, open, readdir, constants } from 'fs/promises';
 import process2, { stdin, stdout } from 'process';
 import crypto, { createHash } from 'crypto';
 import { createServer } from 'http';
 import { createRequire } from 'module';
 
 // package.json
-var version = "6.9.0";
+var version = "6.11.0";
 
 // packages/cli/src/trace-dir-scale.ts
 var TRACE_COUNT_WARN = 1e3;
@@ -2971,9 +2971,9 @@ Trace directory: ${traceDir}`);
     process.exitCode = 1;
   }
   const resolvedOutput = resolveOutputOption(options);
-  const outPath = resolvedOutput !== void 0 ? path14.resolve(resolvedOutput) : void 0;
+  const outPath = resolvedOutput !== void 0 ? path16.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
-    await mkdir(path14.dirname(outPath), { recursive: true });
+    await mkdir(path16.dirname(outPath), { recursive: true });
     await writeFile(outPath, result.content, "utf-8");
     const vlabel = validation !== void 0 ? validation.ok ? "ok" : "failed" : "skipped";
     console.log(`Wrote ${result.fileExtension} export to ${outPath} (validation: ${vlabel})`);
@@ -3011,471 +3011,6 @@ Trace directory: ${traceDir}`);
   }
 }
 
-// packages/core/src/diff/comparable.ts
-function extractOutputPreview(meta) {
-  if (meta === void 0) return void 0;
-  if ("outputPreview" in meta) return meta.outputPreview;
-  if ("resultPreview" in meta) return meta.resultPreview;
-  return void 0;
-}
-function mapStepStatus2(s) {
-  if (s === void 0) return "running";
-  return s;
-}
-function manualTraceEventsToComparableRun(events) {
-  const started = events.find((e) => e.event === "run_started");
-  if (!started || started.event !== "run_started") {
-    throw new Error("Invalid trace: missing run_started");
-  }
-  const rs = started;
-  const runId = rs.runId;
-  const completedAll = events.filter((e) => e.event === "run_completed");
-  const lastCompleted = completedAll[completedAll.length - 1];
-  let runStatus;
-  if (lastCompleted === void 0) runStatus = "running";
-  else runStatus = lastCompleted.status;
-  const durationMs2 = lastCompleted !== void 0 && Number.isFinite(lastCompleted.durationMs) ? lastCompleted.durationMs : void 0;
-  const steps = /* @__PURE__ */ new Map();
-  let order = 0;
-  for (const e of events) {
-    if (e.event !== "step_started") continue;
-    const s = e;
-    const meta = s.metadata ? { ...s.metadata } : void 0;
-    steps.set(s.stepId, {
-      id: s.stepId,
-      parentId: s.parentId,
-      name: s.name,
-      type: s.type,
-      order: order++,
-      timestamp: s.timestamp,
-      metadata: meta
-    });
-  }
-  for (const e of events) {
-    if (e.event !== "step_completed") continue;
-    const acc = steps.get(e.stepId);
-    if (!acc) continue;
-    acc.status = e.status;
-    acc.durationMs = e.durationMs;
-    if (e.error?.message) acc.errorMsg = e.error.message;
-    const extra = e;
-    if (extra.metadata !== void 0 && typeof extra.metadata === "object") {
-      acc.metadata = { ...acc.metadata ?? {}, ...extra.metadata };
-    }
-  }
-  const nodes = /* @__PURE__ */ new Map();
-  for (const acc of steps.values()) {
-    let meta = acc.metadata ? { ...acc.metadata } : void 0;
-    if (acc.parentId !== void 0 && !steps.has(acc.parentId)) {
-      meta = { ...meta ?? {}, agent_inspect_diff_parent_missing: true };
-    }
-    const outputPreview = extractOutputPreview(meta);
-    if (meta !== void 0 && ("outputPreview" in meta || "resultPreview" in meta)) {
-      delete meta.outputPreview;
-      delete meta.resultPreview;
-    }
-    const sc = {
-      id: acc.id,
-      name: acc.name,
-      type: acc.type,
-      status: mapStepStatus2(acc.status),
-      durationMs: acc.durationMs,
-      error: acc.errorMsg,
-      metadata: meta && Object.keys(meta).length > 0 ? meta : void 0,
-      outputPreview,
-      children: []
-    };
-    nodes.set(acc.id, sc);
-  }
-  const roots = [];
-  const sortByOrder = (a, b) => {
-    const oa = steps.get(a.id)?.order ?? 0;
-    const ob = steps.get(b.id)?.order ?? 0;
-    return oa - ob;
-  };
-  for (const acc of steps.values()) {
-    const node = nodes.get(acc.id);
-    if (acc.parentId !== void 0 && nodes.has(acc.parentId)) {
-      nodes.get(acc.parentId).children.push(node);
-    } else {
-      roots.push(node);
-    }
-  }
-  roots.sort(sortByOrder);
-  for (const n of nodes.values()) {
-    n.children.sort(sortByOrder);
-  }
-  return {
-    runId,
-    name: rs.name,
-    status: runStatus,
-    durationMs: durationMs2,
-    steps: roots
-  };
-}
-
-// packages/core/src/diff/engine.ts
-var DEFAULT_THRESHOLD_MS = 0;
-function pathSeg(step, index) {
-  return { index, name: step.name, stepId: step.id };
-}
-function buildPath(segments) {
-  return { path: [...segments] };
-}
-function pairSteps(left, right) {
-  const usedRight = /* @__PURE__ */ new Set();
-  const pairs = [];
-  for (let i = 0; i < left.length; i++) {
-    const L = left[i];
-    let R = right.find((r) => !usedRight.has(r.id) && r.id === L.id);
-    if (R === void 0 && i < right.length && !usedRight.has(right[i].id)) {
-      const cand = right[i];
-      if (cand.name === L.name && (cand.type ?? "") === (L.type ?? "")) {
-        R = cand;
-      }
-    }
-    if (R === void 0) {
-      R = right.find(
-        (r) => !usedRight.has(r.id) && r.name === L.name && (r.type ?? "") === (L.type ?? "")
-      );
-    }
-    if (R !== void 0) {
-      usedRight.add(R.id);
-      pairs.push([L, R]);
-    } else {
-      pairs.push([L, void 0]);
-    }
-  }
-  for (const R of right) {
-    if (!usedRight.has(R.id)) {
-      pairs.push([void 0, R]);
-    }
-  }
-  return pairs;
-}
-function compareLeafSteps(L, R, segments, opts, out) {
-  const path25 = buildPath(segments);
-  if (L.name !== R.name) {
-    out.push({
-      kind: "structure",
-      severity: "warning",
-      message: "Step name differs",
-      path: path25,
-      left: L.name,
-      right: R.name
-    });
-  }
-  if ((L.type ?? "") !== (R.type ?? "")) {
-    out.push({
-      kind: "step-type",
-      severity: "warning",
-      message: "Step type differs",
-      path: path25,
-      left: L.type,
-      right: R.type
-    });
-  }
-  if ((L.status ?? "") !== (R.status ?? "")) {
-    out.push({
-      kind: "step-status",
-      severity: "warning",
-      message: "Step status differs",
-      path: path25,
-      left: L.status,
-      right: R.status
-    });
-  }
-  const le = L.error ?? "";
-  const re = R.error ?? "";
-  if (le !== re) {
-    out.push({
-      kind: "error",
-      severity: "error",
-      message: "Step error message differs",
-      path: path25,
-      left: le || void 0,
-      right: re || void 0
-    });
-  }
-  if (!opts.ignoreDuration) {
-    const ld = L.durationMs;
-    const rd = R.durationMs;
-    const th = opts.durationThresholdMs;
-    let differs = false;
-    if (ld === void 0 && rd === void 0) differs = false;
-    else if (ld === void 0 || rd === void 0) differs = true;
-    else differs = Math.abs(ld - rd) > th;
-    if (differs) {
-      out.push({
-        kind: "duration",
-        severity: "info",
-        message: "Step duration differs",
-        path: path25,
-        left: ld,
-        right: rd
-      });
-    }
-  }
-  const lm = stableJson(L.metadata ?? {});
-  const rm3 = stableJson(R.metadata ?? {});
-  if (lm !== rm3) {
-    out.push({
-      kind: "metadata",
-      severity: "info",
-      message: "Step metadata differs",
-      path: path25,
-      left: L.metadata,
-      right: R.metadata
-    });
-  }
-  const lo = stableJson(L.outputPreview ?? null);
-  const ro = stableJson(R.outputPreview ?? null);
-  if (lo !== ro) {
-    out.push({
-      kind: "output",
-      severity: "info",
-      message: "Output preview differs",
-      path: path25,
-      left: L.outputPreview,
-      right: R.outputPreview
-    });
-  }
-}
-function compareRecursive(L, R, segments, opts, out) {
-  compareLeafSteps(L, R, segments, opts, out);
-  const pairs = pairSteps(L.children, R.children);
-  let ci = 0;
-  for (const [lch, rch] of pairs) {
-    if (lch !== void 0 && rch !== void 0) {
-      compareRecursive(lch, rch, [...segments, pathSeg(lch, ci)], opts, out);
-    } else if (lch !== void 0) {
-      out.push({
-        kind: "step-removed",
-        severity: "warning",
-        message: `Step only in left run: ${lch.name}`,
-        path: buildPath([...segments, pathSeg(lch, ci)]),
-        left: lch.id,
-        right: void 0
-      });
-    } else if (rch !== void 0) {
-      out.push({
-        kind: "step-added",
-        severity: "warning",
-        message: `Step only in right run: ${rch.name}`,
-        path: buildPath([...segments, pathSeg(rch, ci)]),
-        left: void 0,
-        right: rch.id
-      });
-    }
-    ci += 1;
-  }
-}
-function mergeDiffDefaults(options) {
-  return {
-    ignoreDuration: options?.ignoreDuration ?? false,
-    durationThresholdMs: options?.durationThresholdMs !== void 0 ? options.durationThresholdMs : DEFAULT_THRESHOLD_MS,
-    focus: options?.focus ?? "all",
-    check: options?.check ?? "all"
-  };
-}
-function kindMatchesFilter(kind, merged) {
-  const { focus, check } = merged;
-  if (check !== "all") {
-    if (check === "structure") {
-      if (!["step-added", "step-removed", "structure", "step-type"].includes(kind)) return false;
-    } else if (check === "outputs") {
-      if (!["metadata", "output"].includes(kind)) return false;
-    } else if (check === "errors") {
-      if (!["run-status", "step-status", "error"].includes(kind)) return false;
-    } else if (check === "timing") {
-      if (kind !== "duration") return false;
-    }
-  }
-  if (focus !== "all") {
-    if (focus === "errors") {
-      if (!["run-status", "step-status", "error"].includes(kind)) return false;
-    } else if (focus === "structure") {
-      if (!["step-added", "step-removed", "structure", "step-type"].includes(kind)) return false;
-    } else if (focus === "outputs") {
-      if (!["metadata", "output"].includes(kind)) return false;
-    }
-  }
-  return true;
-}
-function diffRuns(left, right, options) {
-  const merged = mergeDiffDefaults(options);
-  const opts = {
-    ignoreDuration: merged.ignoreDuration,
-    durationThresholdMs: merged.durationThresholdMs
-  };
-  const raw = [];
-  if ((left.status ?? "") !== (right.status ?? "")) {
-    raw.push({
-      kind: "run-status",
-      severity: "warning",
-      message: "Run completion status differs",
-      left: left.status,
-      right: right.status
-    });
-  }
-  if (!merged.ignoreDuration) {
-    const ld = left.durationMs;
-    const rd = right.durationMs;
-    const th = merged.durationThresholdMs;
-    let differs = false;
-    if (ld === void 0 && rd === void 0) differs = false;
-    else if (ld === void 0 || rd === void 0) differs = true;
-    else differs = Math.abs(ld - rd) > th;
-    if (differs) {
-      raw.push({
-        kind: "duration",
-        severity: "info",
-        message: "Run duration differs",
-        left: ld,
-        right: rd
-      });
-    }
-  }
-  const pairs = pairSteps(left.steps, right.steps);
-  let idx = 0;
-  for (const [ls, rs] of pairs) {
-    if (ls !== void 0 && rs !== void 0) {
-      compareRecursive(ls, rs, [pathSeg(ls, idx)], opts, raw);
-      idx += 1;
-    } else if (ls !== void 0) {
-      raw.push({
-        kind: "step-removed",
-        severity: "warning",
-        message: `Step only in left run: ${ls.name}`,
-        path: buildPath([pathSeg(ls, idx)]),
-        left: ls.id,
-        right: void 0
-      });
-      idx += 1;
-    } else if (rs !== void 0) {
-      raw.push({
-        kind: "step-added",
-        severity: "warning",
-        message: `Step only in right run: ${rs.name}`,
-        path: buildPath([pathSeg(rs, idx)]),
-        left: void 0,
-        right: rs.id
-      });
-      idx += 1;
-    }
-  }
-  const differences = raw.filter((d) => kindMatchesFilter(d.kind, merged));
-  let errors = 0;
-  let warnings = 0;
-  let info = 0;
-  for (const d of differences) {
-    if (d.severity === "error") errors += 1;
-    else if (d.severity === "warning") warnings += 1;
-    else info += 1;
-  }
-  const firstVisible = differences[0];
-  const firstDivergence = firstVisible !== void 0 ? {
-    kind: "first-divergence",
-    severity: firstVisible.severity,
-    message: `First divergence: ${firstVisible.message}`,
-    path: firstVisible.path,
-    left: firstVisible.left,
-    right: firstVisible.right
-  } : void 0;
-  const summary = {
-    leftRunId: left.runId,
-    rightRunId: right.runId,
-    totalDifferences: differences.length,
-    errors,
-    warnings,
-    info,
-    firstDivergence
-  };
-  return { summary, differences };
-}
-
-// packages/core/src/diff/renderer.ts
-function formatPath(path25) {
-  if (path25 === void 0 || path25.path.length === 0) {
-    return "(run)";
-  }
-  return path25.path.map((s) => s.name).join(" > ");
-}
-function formatValue(v, verbose) {
-  if (v === void 0) return "(undefined)";
-  if (typeof v === "string") return v;
-  if (typeof v === "number" || typeof v === "boolean") return String(v);
-  const s = JSON.stringify(v);
-  if (verbose || s.length <= 120) return s;
-  return `${s.slice(0, 117)}...`;
-}
-function renderRunDiff(result, options) {
-  const verbose = options?.verbose === true;
-  const sev = (s, level) => {
-    return s;
-  };
-  const lines = [];
-  const { summary } = result;
-  lines.push("Run diff");
-  lines.push(`Left:  ${summary.leftRunId}`);
-  lines.push(`Right: ${summary.rightRunId}`);
-  lines.push("");
-  lines.push("Summary:");
-  lines.push(`  Differences: ${summary.totalDifferences}`);
-  lines.push(`  Errors: ${summary.errors}`);
-  lines.push(`  Warnings: ${summary.warnings}`);
-  lines.push(`  Info: ${summary.info}`);
-  lines.push("");
-  const fd = summary.firstDivergence;
-  const firstKind = result.differences[0]?.kind;
-  if (fd !== void 0) {
-    lines.push("First divergence:");
-    const where = formatPath(fd.path);
-    const displayKind = firstKind ?? fd.kind;
-    lines.push(`  ${displayKind} at ${where}`);
-    if (fd.left !== void 0 || fd.right !== void 0) {
-      lines.push(`    left: ${formatValue(fd.left, verbose)}`);
-      lines.push(`    right: ${formatValue(fd.right, verbose)}`);
-    }
-    lines.push("");
-  }
-  lines.push("Differences:");
-  if (result.differences.length === 0) {
-    lines.push("  (none)");
-    return lines.join("\n");
-  }
-  const showSides = (kind) => verbose || [
-    "run-status",
-    "step-status",
-    "error",
-    "duration",
-    "step-type",
-    "structure",
-    "step-added",
-    "step-removed"
-  ].includes(kind);
-  for (const d of result.differences) {
-    const tag = sev(`[${d.severity}]`, d.severity);
-    const pathStr = d.path !== void 0 ? ` ${formatPath(d.path)}` : "";
-    lines.push(`  ${tag} ${d.kind}${pathStr}`);
-    lines.push(`    ${d.message}`);
-    if (d.left !== void 0 || d.right !== void 0) {
-      if (showSides(d.kind)) {
-        lines.push(`    left: ${formatValue(d.left, verbose)}`);
-        lines.push(`    right: ${formatValue(d.right, verbose)}`);
-      }
-    }
-  }
-  return lines.join("\n");
-}
-
-// packages/core/src/diff/index.ts
-function diffTraceEvents(leftEvents, rightEvents, options) {
-  const left = manualTraceEventsToComparableRun(leftEvents);
-  const right = manualTraceEventsToComparableRun(rightEvents);
-  return diffRuns(left, right, options);
-}
-
 // packages/cli/src/diff.ts
 function parseFocus(s) {
   const v = (s ?? "all").trim().toLowerCase();
@@ -3576,7 +3111,10 @@ Trace directory: ${traceDir}`
   }
   console.log(
     renderRunDiff(result, {
-      verbose: options.verbose === true})
+      verbose: options.verbose === true,
+      color: false,
+      json: false
+    })
   );
 }
 
@@ -3779,7 +3317,7 @@ function indexedToMetadata(row, traceDir) {
     endedAt: row.endedAt ?? void 0,
     durationMs: row.durationMs ?? void 0,
     eventCount: 0,
-    filePath: path14.join(traceDir, row.file),
+    filePath: path16.join(traceDir, row.file),
     fileSize: 0,
     createdAt: new Date(row.mtimeMs)
   };
@@ -3808,7 +3346,7 @@ async function newestTraceMtimeMs(traceDir) {
 }
 async function loadSessionRuns(traceDir) {
   try {
-    const mod = await import('./src-C4EUHTER.mjs');
+    const mod = await import('./src-G7PM24W2.mjs');
     const dbPath = mod.resolveIndexDbPath(traceDir);
     const status = mod.indexStatus(dbPath);
     if (!status.healthy) {
@@ -4257,9 +3795,9 @@ async function reportCommand(runId, options = {}) {
     ...options.section ? { section: options.section } : {}
   });
   const resolvedOutput = resolveOutputOption(options);
-  const outPath = resolvedOutput !== void 0 ? path14.resolve(resolvedOutput) : void 0;
+  const outPath = resolvedOutput !== void 0 ? path16.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
-    await mkdir(path14.dirname(outPath), { recursive: true });
+    await mkdir(path16.dirname(outPath), { recursive: true });
     await writeFile(outPath, result.content, "utf-8");
     console.log(`Wrote ${result.fileExtension} report to ${outPath}`);
   }
@@ -4385,8 +3923,8 @@ function passesLuhn(value) {
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var EPOCH_MS_RE = /^1[0-9]{12}$/;
 var EMAIL_RE = /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi;
-function pathSuggestsNonCard(path25) {
-  const normalized = path25.toLowerCase().replace(/[^a-z0-9._]/g, "");
+function pathSuggestsNonCard(path27) {
+  const normalized = path27.toLowerCase().replace(/[^a-z0-9._]/g, "");
   return /(^|\.)(tokenusage|usage)(\.|$)/.test(normalized) || /(startedat|endedat|durationms|timestamp|createdat|updatedat)(\.|$)/.test(normalized) || /(^|\.)(runid|traceid|spanid|eventid|sessionid|userid|parentid|requestid|correlationid)(\.|$)/.test(
     normalized
   ) || /(^|\.)ts(\.|$)/.test(normalized);
@@ -4573,17 +4111,17 @@ function applyRule(rule, value, replacement) {
   }
   return value;
 }
-function childPath(path25, key) {
+function childPath(path27, key) {
   if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
-    return path25 ? `${path25}.${key}` : key;
+    return path27 ? `${path27}.${key}` : key;
   }
-  return `${path25 || "$"}[${JSON.stringify(key)}]`;
+  return `${path27 || "$"}[${JSON.stringify(key)}]`;
 }
-function indexPath(path25, index) {
-  return `${path25 || "$"}[${index}]`;
+function indexPath(path27, index) {
+  return `${path27 || "$"}[${index}]`;
 }
-function makeFinding(path25, detector, action, matchKind, severity = "warning", preview) {
-  return preview === void 0 ? { path: path25, detector, action, severity, matchKind } : { path: path25, detector, action, severity, matchKind, preview };
+function makeFinding(path27, detector, action, matchKind, severity = "warning", preview) {
+  return preview === void 0 ? { path: path27, detector, action, severity, matchKind } : { path: path27, detector, action, severity, matchKind, preview };
 }
 function createRedactionProfile(profile = "local") {
   switch (profile) {
@@ -4652,11 +4190,11 @@ var Redactor2 = class {
   #recordFinding(state, finding) {
     if (this.#collectFindings) state.findings.push(finding);
   }
-  #redactValue(value, key, path25, depth, state) {
+  #redactValue(value, key, path27, depth, state) {
     if (depth > this.#maxDepth) {
       this.#recordFinding(
         state,
-        makeFinding(path25, "structure.maxDepth", "truncate", "value", "warning")
+        makeFinding(path27, "structure.maxDepth", "truncate", "value", "warning")
       );
       return "[Truncated]";
     }
@@ -4665,19 +4203,19 @@ var Redactor2 = class {
       if (rule) {
         this.#recordFinding(
           state,
-          makeFinding(path25, `key.${rule.key}`, actionForRule(rule), "key", "warning")
+          makeFinding(path27, `key.${rule.key}`, actionForRule(rule), "key", "warning")
         );
         return applyRule(rule, value, this.#replacement);
       }
     }
     for (const detector of this.#detectors) {
-      const detections = detector.detect({ path: path25, key, value });
+      const detections = detector.detect({ path: path27, key, value });
       for (const detection of detections) {
         const action = detection.action ?? "replace";
         this.#recordFinding(
           state,
           makeFinding(
-            path25,
+            path27,
             detector.id,
             action,
             detection.matchKind ?? detector.matchKind ?? "custom",
@@ -4695,7 +4233,7 @@ var Redactor2 = class {
       const out = [];
       state.seen.set(value, out);
       value.forEach((item, index) => {
-        out[index] = this.#redactValue(item, void 0, indexPath(path25, index), depth + 1, state);
+        out[index] = this.#redactValue(item, void 0, indexPath(path27, index), depth + 1, state);
       });
       return out;
     }
@@ -4707,7 +4245,7 @@ var Redactor2 = class {
         out[entryKey] = this.#redactValue(
           entryValue,
           entryKey,
-          childPath(path25 === "$" ? "" : path25, entryKey),
+          childPath(path27 === "$" ? "" : path27, entryKey),
           depth + 1,
           state
         );
@@ -5168,14 +4706,14 @@ function uniqueSorted(values) {
   return [...new Set(values)].sort();
 }
 function isWithinDirectory(child, parent) {
-  const relative = path14.relative(parent, child);
-  return relative === "" || !relative.startsWith("..") && !path14.isAbsolute(relative);
+  const relative = path16.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path16.isAbsolute(relative);
 }
 async function resolveOutputPath(inputPath, output2, force) {
   if (output2 === void 0 || output2.trim() === "") return void 0;
-  const inputAbs = path14.resolve(inputPath);
-  const outputAbs = path14.resolve(output2.trim());
-  const inputDir = path14.dirname(inputAbs);
+  const inputAbs = path16.resolve(inputPath);
+  const outputAbs = path16.resolve(output2.trim());
+  const inputDir = path16.dirname(inputAbs);
   if (!isWithinDirectory(outputAbs, inputDir)) {
     throw new Error("Refusing to write migrated output outside the input directory.");
   }
@@ -5296,7 +4834,7 @@ async function migrateCommand(input3, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const inputPath = path14.resolve(input3.trim());
+  const inputPath = path16.resolve(input3.trim());
   const dryRun = options.dryRun === true;
   if (!dryRun && (options.output === void 0 || options.output.trim() === "")) {
     console.error("migrate requires --dry-run or --output <path>.");
@@ -5315,7 +4853,7 @@ async function migrateCommand(input3, options = {}) {
     );
     const result = await buildMigration(inputPath, outputPath);
     if (!dryRun && outputPath !== void 0) {
-      await mkdir(path14.dirname(outputPath), { recursive: true });
+      await mkdir(path16.dirname(outputPath), { recursive: true });
       await writeFile(outputPath, result.content, "utf-8");
     }
     printSummary2(result, dryRun);
@@ -5645,23 +5183,23 @@ function evaluatePromptInjection(text, options = {}) {
   }
   return fail(ruleId, `Matched ${evidence.length} injection pattern(s).`, evidence, "warning");
 }
-function validateSchemaField(value, field, path25, evidence) {
+function validateSchemaField(value, field, path27, evidence) {
   const ruleId = "guardrail.structured-output";
   if (field.type) {
     const actual = value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
     if (actual !== field.type) {
-      evidence.push({ ruleId, path: path25, preview: `expected ${field.type}, got ${actual}` });
+      evidence.push({ ruleId, path: path27, preview: `expected ${field.type}, got ${actual}` });
       return;
     }
   }
   if (field.enum && !field.enum.some((item) => Object.is(item, value))) {
-    evidence.push({ ruleId, path: path25, preview: "value not in enum" });
+    evidence.push({ ruleId, path: path27, preview: "value not in enum" });
   }
   if (field.type === "object" && field.required && value && typeof value === "object" && !Array.isArray(value)) {
     const record = value;
     for (const key of field.required) {
       if (!(key in record)) {
-        evidence.push({ ruleId, path: `${path25}.${key}`, preview: "missing required key" });
+        evidence.push({ ruleId, path: `${path27}.${key}`, preview: "missing required key" });
       }
     }
   }
@@ -5988,7 +5526,7 @@ function asConfig(value) {
 }
 async function loadConfig(configPath) {
   if (configPath === void 0) return {};
-  const extension = path14.extname(configPath);
+  const extension = path16.extname(configPath);
   if (TS_CONFIG_EXTENSIONS.has(extension)) {
     throw new Error(
       "TypeScript check configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -5997,7 +5535,7 @@ async function loadConfig(configPath) {
   if (!CONFIG_EXTENSIONS.has(extension)) {
     throw new Error("Unsupported check config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path14.resolve(configPath);
+  const absolute = path16.resolve(configPath);
   if (extension === ".json") {
     const raw = await readFile(absolute, "utf-8");
     return asConfig(JSON.parse(raw));
@@ -6173,10 +5711,10 @@ function printHuman(result) {
     console.log(`- ${diagnostic3.code}: ${diagnostic3.message}`);
   }
   for (const finding of result.findings) {
-    const path25 = finding.evidence[0]?.path;
+    const path27 = finding.evidence[0]?.path;
     const run = finding.evidence[0]?.runId;
     const runPrefix = run ? `[${run}] ` : "";
-    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path25 ? ` (${path25})` : ""}`);
+    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path27 ? ` (${path27})` : ""}`);
   }
 }
 function readErrorResult(error) {
@@ -6438,7 +5976,7 @@ async function loadSuiteViewerData(options) {
   for (const suiteCase of result.cases) {
     cases.push(await enrichCase(suiteCase, baselinePath));
   }
-  const artifactsDir = path14.join(path14.dirname(result.configPath), ".agent-inspect/suite-runs");
+  const artifactsDir = path16.join(path16.dirname(result.configPath), ".agent-inspect/suite-runs");
   return {
     suiteName: result.suiteName,
     configPath: result.configPath,
@@ -6631,19 +6169,19 @@ function serializeWorkspaceManifest(manifest) {
 }
 var INDEX_DIR_NAME = "index";
 function resolveWorkspaceLocation(cwd = process.cwd()) {
-  const projectRoot = path14.resolve(cwd);
-  const workspaceDir = path14.join(projectRoot, WORKSPACE_DIR_NAME);
+  const projectRoot = path16.resolve(cwd);
+  const workspaceDir = path16.join(projectRoot, WORKSPACE_DIR_NAME);
   return {
     projectRoot,
     workspaceDir,
-    manifestPath: path14.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
+    manifestPath: path16.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
   };
 }
 function resolveInsideWorkspace(workspaceDir, relative) {
-  const base = path14.resolve(workspaceDir);
-  const resolved = path14.resolve(base, relative);
-  const rel = path14.relative(base, resolved);
-  if (rel === "" || rel === "." || !rel.startsWith("..") && !path14.isAbsolute(rel)) {
+  const base = path16.resolve(workspaceDir);
+  const resolved = path16.resolve(base, relative);
+  const rel = path16.relative(base, resolved);
+  if (rel === "" || rel === "." || !rel.startsWith("..") && !path16.isAbsolute(rel)) {
     return resolved;
   }
   throw new Error(
@@ -6712,7 +6250,7 @@ async function createWorkspace(options = {}) {
     created = false;
     adopted = true;
   } else {
-    const project = options.project?.trim() || path14.basename(location.projectRoot) || "workspace";
+    const project = options.project?.trim() || path16.basename(location.projectRoot) || "workspace";
     const traceDirs = detectedExistingTraces ? ["runs", "."] : ["runs"];
     manifest = createDefaultWorkspaceManifest({
       project,
@@ -6851,7 +6389,7 @@ async function doctorWorkspace(location) {
     const abs = resolveInsideWorkspace(location.workspaceDir, rel);
     for (const file of await listJsonl(abs)) {
       try {
-        const s = await stat(path14.join(abs, file));
+        const s = await stat(path16.join(abs, file));
         newestTraceMtime = Math.max(newestTraceMtime, s.mtimeMs);
       } catch {
         checks2.push({ id: "trace-readability", status: "warn", message: `cannot stat ${rel}/${file}` });
@@ -6899,7 +6437,7 @@ async function cleanWorkspace(location, manifest, options = {}) {
       const relPath = `${rel}/${entry}`;
       removed.push(relPath);
       if (!dryRun) {
-        await rm(path14.join(abs, entry), { recursive: true, force: true });
+        await rm(path16.join(abs, entry), { recursive: true, force: true });
       }
     }
   }
@@ -6908,7 +6446,7 @@ async function cleanWorkspace(location, manifest, options = {}) {
 
 // packages/viewer/src/workspace-data.ts
 async function loadWorkspaceViewerData(options) {
-  const cwd = path14.resolve(options.cwd ?? process.cwd());
+  const cwd = path16.resolve(options.cwd ?? process.cwd());
   const location = resolveWorkspaceLocation(cwd);
   const manifestRead = await readWorkspaceManifestFile(location);
   if (!manifestRead.ok || manifestRead.manifest === void 0) {
@@ -6921,7 +6459,7 @@ async function loadWorkspaceViewerData(options) {
   const runs = [];
   for (const rel of manifestRead.manifest.traceDirs) {
     const traceDir = resolveTraceDir({
-      dir: path14.join(location.workspaceDir, rel)
+      dir: path16.join(location.workspaceDir, rel)
     });
     const td = new TraceDirectory({ dir: traceDir });
     const files = await td.list();
@@ -6935,7 +6473,7 @@ async function loadWorkspaceViewerData(options) {
         runId: meta.runId,
         ...meta.name !== void 0 ? { name: meta.name } : {},
         status: meta.status,
-        file: path14.basename(meta.filePath)
+        file: path16.basename(meta.filePath)
       });
     }
   }
@@ -6946,8 +6484,8 @@ async function loadWorkspaceViewerData(options) {
     doctor,
     runs,
     bundleDirs: [
-      path14.join(location.workspaceDir, manifestRead.manifest.bundlesDir),
-      path14.join(location.workspaceDir, manifestRead.manifest.artifactsDir)
+      path16.join(location.workspaceDir, manifestRead.manifest.bundlesDir),
+      path16.join(location.workspaceDir, manifestRead.manifest.artifactsDir)
     ]
   };
 }
@@ -7010,7 +6548,7 @@ function createViewerServer(options = {}) {
           ok: true,
           readOnly: true,
           mode,
-          traceDir: path14.resolve(traceDir)
+          traceDir: path16.resolve(traceDir)
         });
       }
       if (pathname === "/api/suite" && mode === "suite") {
@@ -7039,7 +6577,7 @@ function createViewerServer(options = {}) {
             runId: meta.runId,
             name: meta.name,
             status: meta.status,
-            file: path14.basename(meta.filePath),
+            file: path16.basename(meta.filePath),
             startedAt: meta.startedAt,
             durationMs: meta.durationMs
           }))
@@ -7156,7 +6694,7 @@ function startViewerServer(options = {}) {
       resolve({
         host,
         port: resolvedPort,
-        traceDir: path14.resolve(traceDir),
+        traceDir: path16.resolve(traceDir),
         url: `http://${host}:${resolvedPort}/${modeQuery}`,
         mode
       });
@@ -7527,10 +7065,10 @@ async function evalRun(input3, options = {}) {
     diagnostics: []
   };
 }
-function evidenceForRun(run, path25) {
-  return [{ runId: run.runId, ...path25 !== void 0 ? { path: path25 } : {} }];
+function evidenceForRun(run, path27) {
+  return [{ runId: run.runId, ...path27 !== void 0 ? { path: path27 } : {} }];
 }
-function evidenceForEvent(event, path25) {
+function evidenceForEvent(event, path27) {
   return [
     {
       runId: event.runId,
@@ -7538,7 +7076,7 @@ function evidenceForEvent(event, path25) {
       ...event.parentId !== void 0 ? { parentId: event.parentId } : {},
       kind: event.kind,
       name: event.name,
-      ...path25 !== void 0 ? { path: path25 } : {}
+      ...path27 !== void 0 ? { path: path27 } : {}
     }
   ];
 }
@@ -7696,9 +7234,9 @@ function collectTextFields(nodes, keys, preferredKinds = []) {
 function tokenize(text) {
   return [...text.toLowerCase().matchAll(/[a-z0-9][a-z0-9'-]{2,}/g)].map((match) => match[0].replace(/^['-]+|['-]+$/g, "")).filter((token) => token.length > 2 && !STOP_WORDS.has(token));
 }
-function firstEvidence(fields, run, path25) {
+function firstEvidence(fields, run, path27) {
   const first = fields[0];
-  return first === void 0 ? evidenceForRun(run, path25) : evidenceForEvent(first.node.event, first.path);
+  return first === void 0 ? evidenceForRun(run, path27) : evidenceForEvent(first.node.event, first.path);
 }
 function collectSourceIds(nodes, keys) {
   const wanted = keySet(keys);
@@ -8075,8 +7613,8 @@ function renderEvalMarkdown(result) {
   if (result.findings.length > 0) {
     lines.push("", "## Findings");
     for (const finding of result.findings) {
-      const path25 = finding.evidence[0]?.path;
-      lines.push(`- ${finding.ruleId}: ${finding.message}${path25 ? ` (${path25})` : ""}`);
+      const path27 = finding.evidence[0]?.path;
+      lines.push(`- ${finding.ruleId}: ${finding.message}${path27 ? ` (${path27})` : ""}`);
     }
   }
   return `${lines.join("\n")}
@@ -8123,7 +7661,7 @@ function asConfig2(value) {
 }
 async function loadConfig2(configPath) {
   if (configPath === void 0) return {};
-  const extension = path14.extname(configPath);
+  const extension = path16.extname(configPath);
   if (TS_CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error(
       "TypeScript eval configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -8132,7 +7670,7 @@ async function loadConfig2(configPath) {
   if (!CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error("Unsupported eval config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path14.resolve(configPath);
+  const absolute = path16.resolve(configPath);
   if (extension === ".json") {
     const raw = await readFile(absolute, "utf-8");
     return asConfig2(JSON.parse(raw));
@@ -8269,8 +7807,8 @@ function printHuman2(result) {
     console.log(`- ${diagnostic3.code}: ${diagnostic3.message}`);
   }
   for (const finding of result.findings) {
-    const path25 = finding.evidence[0]?.path;
-    console.log(`- ${finding.ruleId}: ${finding.message}${path25 ? ` (${path25})` : ""}`);
+    const path27 = finding.evidence[0]?.path;
+    console.log(`- ${finding.ruleId}: ${finding.message}${path27 ? ` (${path27})` : ""}`);
   }
 }
 function readErrorResult2(error) {
@@ -8523,14 +8061,14 @@ function exitCodeFor3(result) {
   return 2;
 }
 function explainFinding(finding, blocksBundle) {
-  const path25 = finding.evidence[0]?.path ?? "(unknown path)";
+  const path27 = finding.evidence[0]?.path ?? "(unknown path)";
   const category = finding.category ?? "structure";
   const confidence = finding.confidence ?? "medium";
   const detector = finding.detector ?? finding.ruleId;
   const action = finding.action ?? "review";
   const redactionHint = category === "credential" || category === "personal-data" || category === "raw-content" || action.includes("redact") ? "Usually removable by share/strict redaction before bundling." : "May require omitting the field, lowering limits, or an explicit local override.";
   return [
-    `  Matched: detector=${detector}; path=${path25}; category=${category}`,
+    `  Matched: detector=${detector}; path=${path27}; category=${category}`,
     `  Why: ${finding.message}`,
     `  Confidence: ${confidence}`,
     `  Redaction: ${redactionHint}`,
@@ -8572,9 +8110,9 @@ function printHuman3(result, explain = false) {
     console.log(`- ${diagnostic3.code}: ${diagnostic3.message}`);
   }
   for (const finding of result.findings) {
-    const path25 = finding.evidence[0]?.path;
+    const path27 = finding.evidence[0]?.path;
     const taxonomy = finding.category !== void 0 || finding.confidence !== void 0 ? ` [${[finding.category, finding.confidence].filter(Boolean).join("/")}]` : "";
-    console.log(`- ${finding.ruleId}: ${finding.message}${path25 ? ` (${path25})` : ""}${taxonomy}`);
+    console.log(`- ${finding.ruleId}: ${finding.message}${path27 ? ` (${path27})` : ""}${taxonomy}`);
     if (explain) {
       const blocks = finding.severity === "error" || finding.status === "fail";
       for (const line of explainFinding(finding, blocks)) {
@@ -8688,6 +8226,91 @@ function messageStartsWithDash(error) {
   const message = error instanceof Error ? error.message : String(error);
   return message.startsWith("--");
 }
+function validateReporterArtifactPath(options) {
+  const outputDir = path16.resolve(options.outputDir);
+  const diagnostics = [];
+  const rawPath = options.relativePath;
+  if (rawPath.length === 0) {
+    diagnostics.push({
+      code: "artifact_path_empty",
+      severity: "error",
+      message: "Reporter artifact path must not be empty."
+    });
+    return { ok: false, outputDir, diagnostics };
+  }
+  if (rawPath.includes("\0")) {
+    diagnostics.push({
+      code: "invalid_artifact_path",
+      severity: "error",
+      message: "Reporter artifact path must not contain null bytes.",
+      target: rawPath
+    });
+    return { ok: false, outputDir, diagnostics };
+  }
+  if (path16.isAbsolute(rawPath) || path16.win32.isAbsolute(rawPath)) {
+    diagnostics.push({
+      code: "artifact_path_absolute",
+      severity: "error",
+      message: "Reporter artifact path must be relative.",
+      target: rawPath
+    });
+    return { ok: false, outputDir, diagnostics };
+  }
+  const normalized = path16.posix.normalize(rawPath.replace(/\\/g, "/"));
+  const segments = normalized.split("/");
+  if (normalized === "." || normalized.startsWith("../") || segments.some((segment) => segment === "..")) {
+    diagnostics.push({
+      code: "artifact_path_escape",
+      severity: "error",
+      message: "Reporter artifact path must stay under the output directory.",
+      target: rawPath
+    });
+    return { ok: false, outputDir, diagnostics };
+  }
+  const absolutePath = path16.resolve(outputDir, normalized);
+  const relFromOutput = path16.relative(outputDir, absolutePath);
+  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path16.isAbsolute(relFromOutput)) {
+    diagnostics.push({
+      code: "artifact_path_escape",
+      severity: "error",
+      message: "Reporter artifact path resolved outside the output directory.",
+      target: rawPath
+    });
+    return { ok: false, outputDir, diagnostics };
+  }
+  return {
+    ok: true,
+    outputDir,
+    relativePath: normalized,
+    absolutePath,
+    diagnostics
+  };
+}
+var EVIDENCE_CI_ARTIFACT_FILES = [
+  "evidence.html",
+  "evidence.json",
+  "check-results.json",
+  "trace.jsonl"
+];
+function createEvidenceCiArtifacts(options) {
+  const profile = options.redactionProfile;
+  const prefix = options.relativeDir !== void 0 && options.relativeDir.trim() !== "" ? options.relativeDir.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "") : "";
+  const join = (name) => prefix === "" ? name : path16.posix.join(prefix, name);
+  const formatFor = (name) => {
+    if (name.endsWith(".html")) return "html";
+    if (name.endsWith(".jsonl")) return "jsonl";
+    return "json";
+  };
+  return EVIDENCE_CI_ARTIFACT_FILES.map((name) => ({
+    kind: "evidence",
+    path: join(name),
+    format: formatFor(name),
+    redactionProfile: profile,
+    title: `Evidence v2 ${name}`
+  }));
+}
+
+// packages/cli/src/artifacts.ts
 var NOTE = "Generated locally by AgentInspect. Artifacts are best-effort summaries, not compliance or security certification.";
 var SAFETY_RULES = [
   createSafetyRawContentRule(),
@@ -8761,8 +8384,8 @@ function renderCheckSection(result) {
     `Diagnostics: ${result.diagnostics.length}`
   ];
   for (const finding of result.findings.slice(0, 10)) {
-    const path25 = finding.evidence[0]?.path ?? "(run)";
-    lines.push(`- ${finding.ruleId}: ${finding.message} (${path25})`);
+    const path27 = finding.evidence[0]?.path ?? "(run)";
+    lines.push(`- ${finding.ruleId}: ${finding.message} (${path27})`);
   }
   for (const diagnostic3 of result.diagnostics.slice(0, 10)) {
     lines.push(`- ${diagnostic3.code}: ${diagnostic3.message}`);
@@ -8840,8 +8463,8 @@ function renderHtml(trace, check, diff) {
 `;
 }
 async function writeArtifact(outputDir, relativePath, content, files) {
-  const outPath = path14.join(outputDir, relativePath);
-  await mkdir(path14.dirname(outPath), { recursive: true });
+  const outPath = path16.join(outputDir, relativePath);
+  await mkdir(path16.dirname(outPath), { recursive: true });
   await writeFile(outPath, content, "utf-8");
   files.push(relativePath);
 }
@@ -8856,8 +8479,21 @@ function manifestStatus(check, diff) {
   if (check.summary.warnings > 0 || (diff?.summary.warnings ?? 0) > 0) return "warning";
   return "ok";
 }
+function toEvidenceStatus(status) {
+  if (status === "ok") return "SAFE";
+  if (status === "warning") return "SAFE WITH WARNINGS";
+  if (status === "unsafe" || status === "regression") return "UNSAFE";
+  return "UNKNOWN";
+}
+function shouldWriteEvidence(options, status) {
+  if (options.alwaysEvidence === true) return true;
+  if (options.evidence === false) return false;
+  const onFailureOnly = options.onFailureOnly !== false;
+  if (!onFailureOnly) return true;
+  return status === "unsafe" || status === "regression" || status === "unknown" || status === "warning";
+}
 async function artifactsCommand(target, options = {}, stdin = process.stdin) {
-  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path14.resolve(options.outputDir.trim()) : "";
+  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path16.resolve(options.outputDir.trim()) : "";
   if (outputDir === "") {
     console.error("--output-dir is required.");
     process.exitCode = 1;
@@ -8921,15 +8557,77 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
   );
   await writeArtifact(outputDir, "summary.md", renderMarkdown(trace, check, diff), files);
   await writeArtifact(outputDir, "report.html", renderHtml(trace, check, diff), files);
+  const status = manifestStatus(check, diff);
+  if (shouldWriteEvidence(options, status)) {
+    try {
+      const runIds = selectedRun !== void 0 ? [selectedRun.runId] : read.runs.map((run) => run.runId);
+      const traceDir = resolveTraceDir({ dir: options.dir });
+      const sourceContents = /* @__PURE__ */ new Map();
+      let combined = "";
+      for (const runId of runIds) {
+        const tracePath = getTraceFilePath(runId, traceDir);
+        let raw = "";
+        try {
+          raw = await readFile(tracePath, "utf-8");
+        } catch {
+          raw = `${read.events.filter((event) => event.runId === runId).map((event) => JSON.stringify(event)).join("\n")}
+`;
+        }
+        sourceContents.set(runId, raw);
+        const redacted = redactTraceContent(raw, "strict");
+        combined += redacted.content.endsWith("\n") ? redacted.content : `${redacted.content}
+`;
+      }
+      const checkResultsJson = writeJson3({
+        aggregateStatus: toEvidenceStatus(status),
+        runs: runIds.map((runId) => ({
+          runId,
+          status: toEvidenceStatus(status),
+          errors: check.summary.errors,
+          warnings: check.summary.warnings,
+          findings: check.findings.length
+        }))
+      });
+      const evidencePackage = buildEvidenceCiPackage({
+        generatorVersion: version,
+        runIds,
+        sourceContents,
+        redactedTraceJsonl: combined,
+        redactionProfile: "strict",
+        assessmentStatus: toEvidenceStatus(status),
+        checkResultsJson,
+        summaryText: renderMarkdown(trace, check, diff)
+      });
+      await writeArtifact(outputDir, "evidence.html", evidencePackage["evidence.html"], files);
+      await writeArtifact(outputDir, "evidence.json", evidencePackage["evidence.json"], files);
+      await writeArtifact(
+        outputDir,
+        "check-results.json",
+        evidencePackage["check-results.json"],
+        files
+      );
+      await writeArtifact(outputDir, "trace.jsonl", evidencePackage["trace.jsonl"], files);
+      const expected = createEvidenceCiArtifacts({ redactionProfile: "strict" }).map((a) => a.path);
+      for (const name of expected) {
+        if (!files.includes(name)) {
+          throw new Error(`Evidence CI package missing expected file: ${name}`);
+        }
+      }
+    } catch (error) {
+      console.error(
+        `[AgentInspect] evidence package skipped: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
   const summaryTarget = options.githubSummary ?? process.env.GITHUB_STEP_SUMMARY;
   if (summaryTarget !== void 0 && summaryTarget.trim() !== "") {
-    await mkdir(path14.dirname(path14.resolve(summaryTarget)), { recursive: true });
-    await appendFile(path14.resolve(summaryTarget), `
+    await mkdir(path16.dirname(path16.resolve(summaryTarget)), { recursive: true });
+    await appendFile(path16.resolve(summaryTarget), `
 ${renderMarkdown(trace, check, diff)}`, "utf-8");
   }
   const manifestFiles = [...files, "manifest.json"].sort((a, b) => a.localeCompare(b));
   const manifest = {
-    status: manifestStatus(check, diff),
+    status,
     outputDir,
     files: manifestFiles,
     trace,
@@ -8943,10 +8641,10 @@ ${renderMarkdown(trace, check, diff)}`, "utf-8");
       findings: diff?.findings.length ?? 0,
       diagnostics: diff?.diagnostics.length ?? 0
     },
-    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path14.resolve(summaryTarget) } : {},
+    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path16.resolve(summaryTarget) } : {},
     note: NOTE
   };
-  await writeFile(path14.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
+  await writeFile(path16.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
   if (options.json === true) {
     console.log(writeJson3(manifest).trimEnd());
   } else {
@@ -8988,16 +8686,24 @@ function safetyStatusFromAssess(status) {
   }
   return "UNKNOWN";
 }
-async function resolveOutputDir(options, runIds, cwd) {
+function parseBundleFormat(value) {
+  if (value === void 0 || value === "directory" || value === "html" || value === "zip") {
+    return value ?? "directory";
+  }
+  throw new Error(`Unsupported --format "${value}". Use directory, html, or zip.`);
+}
+async function resolveOutputDir(options, runIds, cwd, format) {
   const out = resolveOutputOption(options);
   if (out !== void 0) {
-    const normalized = normalizeBundleOutputPath(out);
+    const normalized = normalizeBundleOutputPath(out, {
+      preserveZipExtension: format === "zip"
+    });
     try {
       const location = resolveWorkspaceLocation(cwd);
       const manifest = await readWorkspaceManifestFile(location);
       if (manifest.ok && manifest.manifest) {
-        const rel = path14.relative(location.workspaceDir, normalized);
-        if (!rel.startsWith("..") && !path14.isAbsolute(rel)) {
+        const rel = path16.relative(location.workspaceDir, normalized);
+        if (!rel.startsWith("..") && !path16.isAbsolute(rel)) {
           return resolveInsideWorkspace(location.workspaceDir, rel);
         }
       }
@@ -9011,20 +8717,21 @@ async function resolveOutputDir(options, runIds, cwd) {
     if (manifest.ok && manifest.manifest) {
       const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       const label = runIds.length === 1 ? sanitizeBundleRunId(runIds[0]) : `multi-${runIds.length}`;
-      return resolveInsideWorkspace(
+      const base2 = resolveInsideWorkspace(
         location.workspaceDir,
-        path14.join(manifest.manifest.bundlesDir, `bundle-${label}-${stamp}`)
+        path16.join(manifest.manifest.bundlesDir, `bundle-${label}-${stamp}`)
       );
+      return format === "zip" ? `${base2}.zip` : base2;
     }
   } catch {
   }
-  return defaultBundleOutputPath(runIds);
+  const base = defaultBundleOutputPath(runIds);
+  return format === "zip" ? `${base}.zip` : base;
 }
-async function writeBundleFile(outputDir, relativePath, content, files) {
-  const outPath = assertBundlePathContained(outputDir, relativePath);
-  await mkdir(path14.dirname(outPath), { recursive: true });
-  await writeFile(outPath, content, "utf-8");
-  files.push(relativePath);
+function stageBundleFile(relativePath, content, files, packaged) {
+  const safe = assertEvidenceRelativePath(relativePath);
+  if (!files.includes(safe)) files.push(safe);
+  packaged.set(safe, content);
 }
 function renderBundleIndexHtml(parts) {
   const links = parts.runIds.map(
@@ -9062,6 +8769,7 @@ function extractHtmlBody(content) {
 }
 async function bundleCommand(runIdArg, options = {}) {
   const profile = parseBundleProfile(resolveRedactionProfileOption(options));
+  const format = parseBundleFormat(options.format);
   const traceDir = resolveTraceDir({ dir: options.dir });
   const cwd = process.cwd();
   let resolveResult;
@@ -9087,12 +8795,18 @@ async function bundleCommand(runIdArg, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const outputDir = await resolveOutputDir(options, resolveResult.runIds, cwd);
+  const outputDir = await resolveOutputDir(options, resolveResult.runIds, cwd, format);
   const files = [];
+  const packaged = /* @__PURE__ */ new Map();
   const checkRuns = [];
   const redactionRuns = [];
   const htmlByRun = /* @__PURE__ */ new Map();
   const redactedJsonlByRun = /* @__PURE__ */ new Map();
+  const artifactTrees = [];
+  const artifactEventsByRun = /* @__PURE__ */ new Map();
+  const findingSummaries = [];
+  const sourceHashes = [];
+  const schemaVersions = /* @__PURE__ */ new Set();
   let combinedJsonl = "";
   for (const runId of resolveResult.runIds) {
     const tracePath = getTraceFilePath(runId, traceDir);
@@ -9129,6 +8843,14 @@ async function bundleCommand(runIdArg, options = {}) {
     }
     const sourceSafety = assessOpenedTrace(read, { run: runId });
     const sourceStatus = safetyStatusFromAssess(sourceSafety.status);
+    sourceHashes.push({
+      runId,
+      algorithm: "sha256",
+      hash: sha256Hex(rawContent)
+    });
+    for (const version2 of collectTraceSchemaVersions(rawContent)) {
+      schemaVersions.add(version2);
+    }
     const redacted = redactTraceContent(rawContent, toReportProfile(profile));
     redactedJsonlByRun.set(runId, redacted.content);
     combinedJsonl += redacted.content.endsWith("\n") ? redacted.content : `${redacted.content}
@@ -9142,12 +8864,18 @@ async function bundleCommand(runIdArg, options = {}) {
       detectors
     });
     let artifactSafety = sourceSafety;
+    let artifactTree;
     try {
       const artifactRead = await openTrace(
         { type: "string", content: redacted.content },
         { format: "agent-inspect-jsonl" }
       );
       artifactSafety = assessOpenedTrace(artifactRead, { run: runId });
+      artifactTree = artifactRead.runs.find((run) => run.runId === runId) ?? artifactRead.runs[0];
+      artifactEventsByRun.set(
+        runId,
+        artifactRead.events.filter((event) => event.runId === runId)
+      );
     } catch {
       artifactSafety = {
         ...sourceSafety,
@@ -9160,6 +8888,24 @@ async function bundleCommand(runIdArg, options = {}) {
         }
       };
     }
+    for (const finding of artifactSafety.findings) {
+      findingSummaries.push({
+        runId,
+        ruleId: finding.ruleId,
+        severity: finding.severity,
+        message: finding.message,
+        ...finding.category !== void 0 ? { category: finding.category } : {},
+        ...finding.detector !== void 0 ? { detector: finding.detector } : {},
+        ...finding.confidence !== void 0 ? { confidence: finding.confidence } : {},
+        ...finding.action !== void 0 ? { action: finding.action } : {}
+      });
+    }
+    if (artifactTree) {
+      artifactTrees.push(artifactTree);
+    } else {
+      const selected2 = read.runs.find((run) => run.runId === runId);
+      if (selected2) artifactTrees.push(selected2);
+    }
     const status = safetyStatusFromAssess(artifactSafety.status);
     checkRuns.push({
       runId,
@@ -9214,80 +8960,223 @@ async function bundleCommand(runIdArg, options = {}) {
     totalFindings: redactionRuns.reduce((sum, run) => sum + run.findings, 0),
     runs: redactionRuns
   };
-  await mkdir(outputDir, { recursive: true });
   for (const runId of resolveResult.runIds) {
     const jsonl = redactedJsonlByRun.get(runId) ?? "";
-    await writeBundleFile(
-      outputDir,
+    stageBundleFile(
       bundleRunAssetRelativePath(runId, ".jsonl"),
       jsonl,
-      files
+      files,
+      packaged
     );
     const html = htmlByRun.get(runId) ?? "";
-    await writeBundleFile(
-      outputDir,
+    stageBundleFile(
       bundleRunAssetRelativePath(runId, ".html"),
       runReportWrap(html, runId),
-      files
+      files,
+      packaged
     );
   }
   const primaryRunId = resolveResult.runIds[0];
   const traceHtml = resolveResult.runIds.length === 1 ? runReportWrap(htmlByRun.get(primaryRunId) ?? "", primaryRunId) : renderBundleIndexHtml({ runIds: resolveResult.runIds, reports: htmlByRun });
-  await writeBundleFile(outputDir, "trace.jsonl", combinedJsonl, files);
-  await writeBundleFile(outputDir, "trace.html", traceHtml, files);
-  await writeBundleFile(
-    outputDir,
-    "check-results.json",
-    writeJson4(checks2),
-    files
-  );
-  await writeBundleFile(
-    outputDir,
+  stageBundleFile("trace.jsonl", combinedJsonl, files, packaged);
+  stageBundleFile("trace.html", traceHtml, files, packaged);
+  stageBundleFile("check-results.json", writeJson4(checks2), files, packaged);
+  stageBundleFile(
     "eval-results.json",
     writeJson4(buildPlaceholderArtifact()),
-    files
+    files,
+    packaged
   );
-  await writeBundleFile(
-    outputDir,
+  stageBundleFile(
     "redaction-report.json",
     writeJson4(redactionReport),
-    files
+    files,
+    packaged
   );
-  await writeBundleFile(
-    outputDir,
+  stageBundleFile(
     "performance-summary.json",
     writeJson4(buildPlaceholderArtifact()),
-    files
+    files,
+    packaged
+  );
+  const summaryPath = "summary.md";
+  const metadataPath = "metadata.json";
+  const aggregateSourceStatus = aggregateBundleSafeStatus(
+    checkRuns.map((run) => run.sourceStatus ?? run.status)
   );
+  const metadataFileList = [
+    ...files,
+    summaryPath,
+    EVIDENCE_HTML_FILENAME,
+    metadataPath,
+    EVIDENCE_MANIFEST_FILENAME
+  ].filter((name, index, all) => all.indexOf(name) === index).sort((a, b) => a.localeCompare(b));
   const metadata = buildBundleMetadata({
     agentInspectVersion: version,
     profile,
     resolve: resolveResult,
     checks: checks2,
-    files: [...files]
+    files: metadataFileList
   });
-  await writeBundleFile(outputDir, "metadata.json", writeJson4(metadata), files);
-  await writeBundleFile(
-    outputDir,
-    "summary.md",
-    buildBundleSummaryMarkdown({ metadata, checks: checks2, redaction: redactionReport }),
-    files
+  const summaryMd = buildBundleSummaryMarkdown({
+    metadata,
+    checks: checks2,
+    redaction: redactionReport
+  });
+  const evidenceHtml = buildEvidenceHtmlShell({
+    title: "AgentInspect evidence",
+    runIds: resolveResult.runIds,
+    assessmentStatus: checks2.aggregateStatus,
+    sourceStatus: aggregateSourceStatus,
+    redactionProfile: profile,
+    verificationPolicy: profile,
+    generatorName: "agent-inspect",
+    generatorVersion: version,
+    createdAt: metadata.createdAt,
+    summaryText: summaryMd,
+    checkSummary: {
+      aggregateStatus: checks2.aggregateStatus,
+      runs: checkRuns
+    },
+    viewBodies: {
+      tree: buildEvidenceTreeViewHtml(artifactTrees),
+      timeline: buildEvidenceTimelineViewHtml(artifactTrees),
+      causal: buildEvidenceCausalFailureViewHtml(artifactTrees),
+      "tools-llm": buildEvidenceToolsLlmViewHtml(artifactTrees),
+      contracts: buildEvidenceContractsViewHtml({
+        aggregateStatus: checks2.aggregateStatus,
+        runs: checkRuns,
+        findingSummaries
+      }),
+      outcomes: buildEvidenceOutcomesViewHtml(
+        resolveResult.runIds.map((id) => ({
+          runId: id,
+          events: artifactEventsByRun.get(id) ?? []
+        }))
+      ),
+      circuit: buildEvidenceCircuitViewHtml(),
+      diff: resolveResult.runIds.length >= 2 ? buildEvidenceDiffViewHtml({
+        leftRunId: resolveResult.runIds[0],
+        rightRunId: resolveResult.runIds[1],
+        leftEvents: artifactEventsByRun.get(resolveResult.runIds[0]) ?? [],
+        rightEvents: artifactEventsByRun.get(resolveResult.runIds[1]) ?? []
+      }) : buildEvidenceDiffViewHtml(),
+      safety: buildEvidenceSafetyViewHtml({
+        artifactStatus: checks2.aggregateStatus,
+        sourceStatus: aggregateSourceStatus,
+        redactionProfile: profile,
+        verificationPolicy: profile,
+        redaction: redactionReport,
+        findingSummaries
+      }),
+      provenance: buildEvidenceProvenanceViewHtml({
+        generatorName: "agent-inspect",
+        generatorVersion: version,
+        evidenceFormatVersion: EVIDENCE_FORMAT_VERSION,
+        createdAt: metadata.createdAt,
+        runIds: resolveResult.runIds,
+        traceSchemaVersions: [...schemaVersions].sort((a, b) => a.localeCompare(b)),
+        sourceHashes,
+        packagedFiles: metadataFileList.filter((name) => name !== EVIDENCE_MANIFEST_FILENAME).map((name) => ({ path: name, role: inferEvidenceFileRole(name) }))
+      })
+    }
+  });
+  stageBundleFile(EVIDENCE_HTML_FILENAME, evidenceHtml, files, packaged);
+  stageBundleFile(summaryPath, summaryMd, files, packaged);
+  const metadataJson = writeJson4(metadata);
+  packaged.set(metadataPath, metadataJson);
+  if (!files.includes(metadataPath)) {
+    files.push(metadataPath);
+  }
+  const evidenceFiles = [...packaged.entries()].map(
+    ([relativePath, content]) => ({ path: relativePath, content })
   );
-  metadata.files = [...files].sort((a, b) => a.localeCompare(b));
-  await writeFile(path14.join(outputDir, "metadata.json"), writeJson4(metadata), "utf-8");
+  const evidence = buildEvidenceManifest({
+    generatorVersion: version,
+    runIds: resolveResult.runIds,
+    traceSchemaVersions: [...schemaVersions].sort((a, b) => a.localeCompare(b)),
+    sourceHashes,
+    redactionProfile: profile,
+    verificationPolicy: profile,
+    assessmentStatus: checks2.aggregateStatus,
+    sourceStatus: aggregateSourceStatus,
+    files: evidenceFiles,
+    createdAt: metadata.createdAt
+  });
+  let evidenceJson = serializeEvidenceManifest(evidence);
+  let outputPath = outputDir;
+  if (format === "html") {
+    const htmlContent = packaged.get(EVIDENCE_HTML_FILENAME) ?? evidenceHtml;
+    const htmlEvidence = buildEvidenceManifest({
+      generatorVersion: version,
+      runIds: resolveResult.runIds,
+      traceSchemaVersions: [...schemaVersions].sort((a, b) => a.localeCompare(b)),
+      sourceHashes,
+      redactionProfile: profile,
+      verificationPolicy: profile,
+      assessmentStatus: checks2.aggregateStatus,
+      sourceStatus: aggregateSourceStatus,
+      files: [{ path: EVIDENCE_HTML_FILENAME, content: htmlContent }],
+      createdAt: metadata.createdAt
+    });
+    evidenceJson = serializeEvidenceManifest(htmlEvidence);
+    let htmlPath = outputDir;
+    let sidecarDir = outputDir;
+    if (outputDir.toLowerCase().endsWith(".html")) {
+      htmlPath = outputDir;
+      sidecarDir = path16.dirname(outputDir);
+    } else {
+      await mkdir(outputDir, { recursive: true });
+      htmlPath = path16.join(outputDir, EVIDENCE_HTML_FILENAME);
+      sidecarDir = outputDir;
+    }
+    await mkdir(sidecarDir, { recursive: true });
+    await writeFile(htmlPath, htmlContent, "utf-8");
+    await writeFile(path16.join(sidecarDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
+    outputPath = htmlPath;
+  } else if (format === "zip") {
+    const zipPath = outputDir.toLowerCase().endsWith(".zip") ? outputDir : `${outputDir}.zip`;
+    const zipParent = path16.dirname(zipPath);
+    await mkdir(zipParent, { recursive: true });
+    const entries = [
+      ...[...packaged.entries()].map(([relativePath, content]) => ({
+        path: relativePath,
+        content
+      })),
+      { path: EVIDENCE_MANIFEST_FILENAME, content: evidenceJson }
+    ];
+    const archive = buildZipArchive(entries);
+    await writeFile(zipPath, archive);
+    outputPath = zipPath;
+  } else {
+    await mkdir(outputDir, { recursive: true });
+    for (const [relativePath, content] of packaged.entries()) {
+      const outPath = assertBundlePathContained(outputDir, relativePath);
+      await mkdir(path16.dirname(outPath), { recursive: true });
+      await writeFile(outPath, content, "utf-8");
+    }
+    await writeFile(path16.join(outputDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
+    if (!files.includes(EVIDENCE_MANIFEST_FILENAME)) {
+      files.push(EVIDENCE_MANIFEST_FILENAME);
+    }
+    outputPath = outputDir;
+  }
   if (options.json) {
     console.log(
       writeJson4({
         ok: true,
-        outputDir,
+        format,
+        outputDir: outputPath,
         metadata,
+        evidence: format === "html" ? JSON.parse(evidenceJson) : evidence,
         checks: checks2,
         redaction: redactionReport
       }).trimEnd()
     );
     return;
   }
-  console.log(`Bundle written to ${outputDir}`);
+  console.log(`Bundle written to ${outputPath}`);
+  console.log(`Format: ${format}`);
   console.log(`Safe status: ${metadata.safeStatus}`);
   console.log(`Runs: ${resolveResult.runIds.join(", ")}`);
   console.log(`Files: ${metadata.files.length}`);
@@ -9307,68 +9196,179 @@ ${body}
 </html>
 `;
 }
-function validateReporterArtifactPath(options) {
-  const outputDir = path14.resolve(options.outputDir);
-  const diagnostics = [];
-  const rawPath = options.relativePath;
-  if (rawPath.length === 0) {
-    diagnostics.push({
-      code: "artifact_path_empty",
-      severity: "error",
-      message: "Reporter artifact path must not be empty."
-    });
-    return { ok: false, outputDir, diagnostics };
+function writeJson5(value) {
+  return `${JSON.stringify(value, null, 2)}
+`;
+}
+async function bundleVerifyCommand(targetPath, options = {}) {
+  const root = path16.resolve(targetPath.trim() || ".");
+  const result = await verifyEvidenceDirectory(root, {
+    unexpectedFiles: options.unexpected ?? "fail"
+  });
+  if (options.json) {
+    console.log(
+      writeJson5({
+        ok: result.ok,
+        status: result.status,
+        root: result.root,
+        checkedFiles: result.checkedFiles,
+        issues: result.issues,
+        assessment: result.manifest?.assessment,
+        generator: result.manifest?.generator
+      }).trimEnd()
+    );
+  } else if (result.ok) {
+    console.log(`Evidence verify: pass (${result.checkedFiles} file(s) checked)`);
+    console.log(`Root: ${result.root}`);
+    if (result.manifest?.assessment?.status) {
+      console.log(`Assessment: ${result.manifest.assessment.status}`);
+    }
+  } else {
+    console.error(`Evidence verify: fail (${result.issues.length} issue(s))`);
+    console.error(`Root: ${result.root}`);
+    for (const issue of result.issues) {
+      console.error(`- [${issue.severity}] ${issue.code}: ${issue.message}`);
+    }
   }
-  if (rawPath.includes("\0")) {
-    diagnostics.push({
-      code: "invalid_artifact_path",
-      severity: "error",
-      message: "Reporter artifact path must not contain null bytes.",
-      target: rawPath
-    });
-    return { ok: false, outputDir, diagnostics };
+  if (!result.ok) {
+    process.exitCode = 1;
   }
-  if (path14.isAbsolute(rawPath) || path14.win32.isAbsolute(rawPath)) {
-    diagnostics.push({
-      code: "artifact_path_absolute",
-      severity: "error",
-      message: "Reporter artifact path must be relative.",
-      target: rawPath
-    });
-    return { ok: false, outputDir, diagnostics };
+}
+var CLIENTS = [
+  "cursor",
+  "claude-code",
+  "codex",
+  "gemini"
+];
+function isMcpConfigureClient(value) {
+  return CLIENTS.includes(value);
+}
+function buildServerBlock(traceDir) {
+  return {
+    command: "npx",
+    args: ["-y", "@agent-inspect/mcp-server", "--dir", traceDir],
+    env: {
+      AGENT_INSPECT_TRACE_DIR: traceDir,
+      AGENT_INSPECT_MCP_REDACTION_PROFILE: "share"
+    }
+  };
+}
+function buildMcpClientConfig(client, traceDir) {
+  const server = buildServerBlock(traceDir);
+  switch (client) {
+    case "cursor":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    case "claude-code":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    case "codex":
+      return {
+        mcp_servers: {
+          "agent-inspect": {
+            command: server.command,
+            args: server.args,
+            env: server.env
+          }
+        }
+      };
+    case "gemini":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    default: {
+      const _exhaustive = client;
+      return _exhaustive;
+    }
   }
-  const normalized = path14.posix.normalize(rawPath.replace(/\\/g, "/"));
-  const segments = normalized.split("/");
-  if (normalized === "." || normalized.startsWith("../") || segments.some((segment) => segment === "..")) {
-    diagnostics.push({
-      code: "artifact_path_escape",
-      severity: "error",
-      message: "Reporter artifact path must stay under the output directory.",
-      target: rawPath
-    });
-    return { ok: false, outputDir, diagnostics };
+}
+function resolveTargetPath(client, projectLocal) {
+  if (projectLocal) {
+    switch (client) {
+      case "cursor":
+        return path16.join(".cursor", "mcp.json");
+      case "claude-code":
+        return path16.join(".mcp.json");
+      case "codex":
+        return path16.join(".codex", "config.toml.json");
+      case "gemini":
+        return path16.join(".gemini", "settings.json");
+    }
   }
-  const absolutePath = path14.resolve(outputDir, normalized);
-  const relFromOutput = path14.relative(outputDir, absolutePath);
-  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path14.isAbsolute(relFromOutput)) {
-    diagnostics.push({
-      code: "artifact_path_escape",
-      severity: "error",
-      message: "Reporter artifact path resolved outside the output directory.",
-      target: rawPath
-    });
-    return { ok: false, outputDir, diagnostics };
+  switch (client) {
+    case "cursor":
+      return path16.join("~", ".cursor", "mcp.json");
+    case "claude-code":
+      return path16.join("~", ".claude.json");
+    case "codex":
+      return path16.join("~", ".codex", "config.toml");
+    case "gemini":
+      return path16.join("~", ".gemini", "settings.json");
   }
-  return {
-    ok: true,
-    outputDir,
-    relativePath: normalized,
-    absolutePath,
-    diagnostics
+}
+async function mcpConfigureCommand(options) {
+  if (!isMcpConfigureClient(options.client)) {
+    throw new Error(
+      `Unsupported client "${String(options.client)}". Use: ${CLIENTS.join(", ")}`
+    );
+  }
+  const traceDir = options.dir?.trim() || ".agent-inspect";
+  const projectLocal = Boolean(options.projectLocal);
+  const write = Boolean(options.write);
+  const yes = Boolean(options.yes);
+  const dryRun = !(write && yes && projectLocal);
+  const config = buildMcpClientConfig(options.client, traceDir);
+  const targetPath = resolveTargetPath(options.client, projectLocal);
+  const notes = [
+    "Read-only MCP server; no network upload; share redaction by default.",
+    "Dry-run by default. Pass --project-local --write --yes to write a project file.",
+    "User-level paths are never auto-written by this command.",
+    "Remove the agent-inspect server block to uninstall."
+  ];
+  let wrote = false;
+  if (!dryRun && projectLocal) {
+    const abs = path16.resolve(targetPath);
+    await mkdir(path16.dirname(abs), { recursive: true });
+    await writeFile(abs, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+    wrote = true;
+  }
+  const result = {
+    client: options.client,
+    dryRun,
+    wrote,
+    targetPath,
+    config,
+    notes
   };
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+  } else {
+    process.stdout.write(
+      [
+        `Client: ${result.client}`,
+        `Mode: ${result.dryRun ? "dry-run" : "write"}`,
+        `Target: ${result.targetPath}`,
+        `Wrote: ${result.wrote}`,
+        "",
+        JSON.stringify(result.config, null, 2),
+        "",
+        ...result.notes.map((note) => `- ${note}`),
+        ""
+      ].join("\n")
+    );
+  }
+  return result;
 }
-
-// packages/cli/src/ci-summary.ts
 var NOTE2 = "Generated locally by AgentInspect from reporter artifact manifests. Trace contents are not embedded.";
 var MAX_TEXT = 180;
 var FRAMEWORKS = /* @__PURE__ */ new Set(["vitest", "jest", "manual"]);
@@ -9384,7 +9384,7 @@ function stable7(value) {
     Object.keys(record).sort((a, b) => a.localeCompare(b)).map((key) => [key, stable7(record[key])])
   );
 }
-function writeJson5(value) {
+function writeJson6(value) {
   return `${JSON.stringify(stable7(value), null, 2)}
 `;
 }
@@ -9496,23 +9496,23 @@ function readManifestDocument(value) {
   };
 }
 function cwdRelative(filePath) {
-  const relative = path14.relative(process.cwd(), path14.resolve(filePath)).replace(/\\/g, "/");
-  if (relative === "" || relative.startsWith("../") || path14.isAbsolute(relative)) {
-    return path14.basename(filePath);
+  const relative = path16.relative(process.cwd(), path16.resolve(filePath)).replace(/\\/g, "/");
+  if (relative === "" || relative.startsWith("../") || path16.isAbsolute(relative)) {
+    return path16.basename(filePath);
   }
   return relative;
 }
 async function readReporterManifest(filePath) {
-  const absolute = path14.resolve(filePath);
+  const absolute = path16.resolve(filePath);
   const raw = await readFile(absolute, "utf-8");
   const document = readManifestDocument(JSON.parse(raw));
   const manifest = document.manifest;
   const results = manifest.results.map((result) => ({
     testId: safeText(result.testId),
     name: safeText(result.name),
-    ...result.file === void 0 ? {} : { file: safeText(path14.basename(result.file)) },
+    ...result.file === void 0 ? {} : { file: safeText(path16.basename(result.file)) },
     status: result.status,
-    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path14.basename(result.tracePath)) },
+    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path16.basename(result.tracePath)) },
     artifacts: result.artifacts,
     diagnostics: result.diagnostics
   }));
@@ -9651,20 +9651,20 @@ async function ciSummaryCommand(manifestPaths, options = {}) {
     return;
   }
   const markdown = renderMarkdown2(result);
-  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path14.resolve(options.output.trim()) : void 0;
+  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path16.resolve(options.output.trim()) : void 0;
   if (outputPath !== void 0) {
-    await mkdir(path14.dirname(outputPath), { recursive: true });
+    await mkdir(path16.dirname(outputPath), { recursive: true });
     await writeFile(outputPath, markdown, "utf-8");
   }
   const summaryTarget = options.githubSummary ?? process.env.GITHUB_STEP_SUMMARY;
   if (summaryTarget !== void 0 && summaryTarget.trim() !== "") {
-    const summaryPath = path14.resolve(summaryTarget);
-    await mkdir(path14.dirname(summaryPath), { recursive: true });
+    const summaryPath = path16.resolve(summaryTarget);
+    await mkdir(path16.dirname(summaryPath), { recursive: true });
     await appendFile(summaryPath, `
 ${markdown}`, "utf-8");
   }
   if (options.json === true) {
-    console.log(writeJson5(result).trimEnd());
+    console.log(writeJson6(result).trimEnd());
   } else if (outputPath !== void 0) {
     console.log(`Wrote AgentInspect CI summary to ${outputPath}`);
     console.log(`Status: ${result.status}`);
@@ -9807,7 +9807,7 @@ jobs:
 }
 async function planInit(options = {}) {
   const framework = normalizeFramework(options.framework);
-  const cwd = path14.resolve(options.cwd ?? process.cwd());
+  const cwd = path16.resolve(options.cwd ?? process.cwd());
   const demoPath = framework === "custom" ? "examples/agent-inspect-demo.mjs" : `examples/agent-inspect-${framework}-demo.mjs`;
   const candidates = [
     { rel: CONFIG_FILE, content: configTemplate(framework) },
@@ -9822,7 +9822,7 @@ async function planInit(options = {}) {
   }
   const files = [];
   for (const candidate of candidates) {
-    const abs = path14.join(cwd, candidate.rel);
+    const abs = path16.join(cwd, candidate.rel);
     try {
       await access(abs);
       files.push({
@@ -9843,12 +9843,12 @@ async function writePlannedFiles(plan, cwd, options) {
     if (entry.action === "skip") {
       continue;
     }
-    const abs = path14.join(cwd, entry.path);
+    const abs = path16.join(cwd, entry.path);
     if (options.dryRun) {
       written.push(entry.path);
       continue;
     }
-    await mkdir(path14.dirname(abs), { recursive: true });
+    await mkdir(path16.dirname(abs), { recursive: true });
     const content = entry.path === CONFIG_FILE ? configTemplate(plan.framework) : entry.path === GITKEEP ? "" : entry.path.endsWith(".yml") ? githubWorkflowTemplate() : demoTemplate(plan.framework);
     await writeFile(abs, content, "utf-8");
     written.push(entry.path);
@@ -9856,7 +9856,7 @@ async function writePlannedFiles(plan, cwd, options) {
   return written;
 }
 async function initCommand(options = {}) {
-  const cwd = path14.resolve(options.cwd ?? process.cwd());
+  const cwd = path16.resolve(options.cwd ?? process.cwd());
   try {
     const plan = await planInit({ ...options, cwd });
     const toWrite = plan.files.filter((file) => file.action === "create").map((f) => f.path);
@@ -9947,7 +9947,7 @@ function envCheck(name, optional = true) {
   };
 }
 async function traceDirWritable(traceDir) {
-  const resolved = path14.resolve(traceDir);
+  const resolved = path16.resolve(traceDir);
   try {
     await mkdir(resolved, { recursive: true });
     await access(resolved, constants.W_OK);
@@ -9968,10 +9968,10 @@ async function traceDirWritable(traceDir) {
   }
 }
 function readPackageVersionNearEntry(entryPath, packageName) {
-  let dir = path14.dirname(path14.resolve(entryPath));
-  const { root } = path14.parse(dir);
+  let dir = path16.dirname(path16.resolve(entryPath));
+  const { root } = path16.parse(dir);
   while (true) {
-    const candidate = path14.join(dir, "package.json");
+    const candidate = path16.join(dir, "package.json");
     if (existsSync(candidate)) {
       try {
         const pkg = JSON.parse(readFileSync(candidate, "utf8"));
@@ -9982,14 +9982,14 @@ function readPackageVersionNearEntry(entryPath, packageName) {
       }
     }
     if (dir === root) break;
-    const parent = path14.dirname(dir);
+    const parent = path16.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   return void 0;
 }
 function resolveInstalledPackage(cwd, name) {
-  const require2 = createRequire(path14.join(cwd, "package.json"));
+  const require2 = createRequire(path16.join(cwd, "package.json"));
   try {
     const entry = require2.resolve(name);
     let version2;
@@ -10087,7 +10087,7 @@ function versionMismatchCheck(cwd) {
   };
 }
 async function runDoctorChecks(options = {}) {
-  const cwd = path14.resolve(options.cwd ?? process2.cwd());
+  const cwd = path16.resolve(options.cwd ?? process2.cwd());
   const traceDir = options.traceDir?.trim() || process2.env.AGENT_INSPECT_TRACE_DIR?.trim() || ".agent-inspect";
   const checks2 = [
     nodeVersionCheck(),
@@ -10327,7 +10327,7 @@ function parsePluginManifest(input3) {
   };
 }
 async function readPluginManifestFile(packageDir) {
-  const manifestPath = path14.join(packageDir, PLUGIN_MANIFEST_FILENAME);
+  const manifestPath = path16.join(packageDir, PLUGIN_MANIFEST_FILENAME);
   try {
     const raw = await readFile(manifestPath, "utf8");
     const parsed = parsePluginManifest(JSON.parse(raw));
@@ -10353,7 +10353,7 @@ async function indexIsStale(snapshot, traceDir) {
   const files = await td.list();
   for (const file of files) {
     const stats = await td.getFileStats(file);
-    if (stats.mtimeMs > builtMs) return true;
+    if (Math.floor(stats.mtimeMs) > builtMs) return true;
   }
   return false;
 }
@@ -10401,7 +10401,7 @@ function createTraceDirectoryIndexer() {
 // packages/cli/src/plugins.ts
 async function readPackageName(packageDir) {
   try {
-    const raw = await readFile(path14.join(packageDir, "package.json"), "utf8");
+    const raw = await readFile(path16.join(packageDir, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     return typeof parsed.name === "string" ? parsed.name : void 0;
   } catch {
@@ -10409,7 +10409,7 @@ async function readPackageName(packageDir) {
   }
 }
 async function discoverPlugins(cwd = process.cwd()) {
-  const nodeModules = path14.join(cwd, "node_modules");
+  const nodeModules = path16.join(cwd, "node_modules");
   const found = [];
   let entries;
   try {
@@ -10420,7 +10420,7 @@ async function discoverPlugins(cwd = process.cwd()) {
   for (const entry of entries.sort()) {
     if (entry.startsWith("@")) continue;
     if (!isPluginPackageName(entry)) continue;
-    const packageDir = path14.join(nodeModules, entry);
+    const packageDir = path16.join(nodeModules, entry);
     const manifestRead = await readPluginManifestFile(packageDir);
     found.push({
       packageName: entry,
@@ -10433,7 +10433,7 @@ async function discoverPlugins(cwd = process.cwd()) {
   return found;
 }
 async function validatePluginPackage(packageRef, cwd = process.cwd()) {
-  const packageDir = path14.isAbsolute(packageRef) ? packageRef : path14.join(cwd, "node_modules", packageRef);
+  const packageDir = path16.isAbsolute(packageRef) ? packageRef : path16.join(cwd, "node_modules", packageRef);
   const packageName = await readPackageName(packageDir) ?? packageRef;
   const errors = [];
   const warnings = [];
@@ -10509,7 +10509,7 @@ async function pluginsValidateCommand(packageRef, cwd) {
 }
 var INDEX_FILENAME = ".agent-inspect-index.json";
 function traceIndexPath(traceDir) {
-  return path14.join(traceDir, INDEX_FILENAME);
+  return path16.join(traceDir, INDEX_FILENAME);
 }
 function parseMaxEntries(raw) {
   if (raw === void 0 || raw.trim() === "") return void 0;
@@ -10622,7 +10622,7 @@ function isModuleNotFound4(e) {
 }
 async function loadIndexSqlite() {
   try {
-    return await import('./src-C4EUHTER.mjs');
+    return await import('./src-G7PM24W2.mjs');
   } catch (e) {
     if (isModuleNotFound4(e)) {
       console.error(
@@ -10652,7 +10652,7 @@ async function newestTraceMtimeMs2(traceDir) {
     for (const file of files) {
       if (!file.endsWith(".jsonl")) continue;
       try {
-        const s = await stat(path14.join(traceDir, file));
+        const s = await stat(path16.join(traceDir, file));
         if (s.mtimeMs > newest) newest = s.mtimeMs;
       } catch {
       }
@@ -10904,11 +10904,11 @@ function printJson5(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function resolveCwd(options) {
-  return path14.resolve(options.cwd ?? process.cwd());
+  return path16.resolve(options.cwd ?? process.cwd());
 }
 async function suiteInitCommand(options = {}) {
   const cwd = resolveCwd(options);
-  const configPath = path14.join(cwd, DEFAULT_CONFIG_FILENAME);
+  const configPath = path16.join(cwd, DEFAULT_CONFIG_FILENAME);
   const template = options.template?.trim();
   const suiteConfig = template !== void 0 && template !== "" ? resolveSuiteTemplate(template) : defaultSuiteConfigTemplate();
   if (options.dryRun) {
@@ -11027,13 +11027,13 @@ async function suiteListCommand(options = {}) {
 }
 async function writeSuiteArtifact(result, configOutputDir, options) {
   const cwd = resolveCwd(options);
-  const outputDir = path14.resolve(
+  const outputDir = path16.resolve(
     cwd,
     options.output ?? configOutputDir ?? DEFAULT_SUITE_ARTIFACTS_DIR
   );
   await mkdir(outputDir, { recursive: true });
   const stamp = result.startedAt.replace(/[:.]/g, "-");
-  const filePath = path14.join(outputDir, `${result.suiteName}-${stamp}.json`);
+  const filePath = path16.join(outputDir, `${result.suiteName}-${stamp}.json`);
   await writeFile(filePath, `${JSON.stringify(result, null, 2)}
 `, "utf-8");
   return filePath;
@@ -11091,7 +11091,7 @@ async function loadSuiteResultFromInput(options) {
   if (options.input === void 0 || options.input.trim() === "") {
     throw new Error("Pass --input <suite-run.json> from a prior suite run.");
   }
-  const inputPath = path14.resolve(cwd, options.input.trim());
+  const inputPath = path16.resolve(cwd, options.input.trim());
   const raw = await readFile(inputPath, "utf-8");
   return JSON.parse(raw);
 }
@@ -11125,9 +11125,9 @@ function normalizeMetrics(raw) {
 }
 async function writeArtifacts(result, outputDir) {
   await mkdir(outputDir, { recursive: true });
-  const jsonPath = path14.join(outputDir, "cohort-results.json");
-  const markdownPath = path14.join(outputDir, "cohort-summary.md");
-  const htmlPath = path14.join(outputDir, "cohort-report.html");
+  const jsonPath = path16.join(outputDir, "cohort-results.json");
+  const markdownPath = path16.join(outputDir, "cohort-summary.md");
+  const htmlPath = path16.join(outputDir, "cohort-report.html");
   await writeFile(jsonPath, `${renderCohortReport(result, { format: "json" })}
 `, "utf-8");
   await writeFile(
@@ -11155,7 +11155,7 @@ async function cohortCommand(options = {}) {
     const format = options.format ?? (options.json ? "json" : "markdown");
     let artifacts;
     if (options.output !== void 0 && options.output.trim() !== "") {
-      artifacts = await writeArtifacts(result, path14.resolve(options.output.trim()));
+      artifacts = await writeArtifacts(result, path16.resolve(options.output.trim()));
     }
     if (options.json || format === "json") {
       console.log(
@@ -11225,11 +11225,11 @@ function parseDuration2(value) {
 async function writeArtifacts2(result, outputDir) {
   await mkdir(outputDir, { recursive: true });
   const paths = {
-    jsonPath: path14.join(outputDir, "gate-results.json"),
-    markdownPath: path14.join(outputDir, "gate-summary.md"),
-    htmlPath: path14.join(outputDir, "gate-report.html"),
-    junitPath: path14.join(outputDir, "junit.xml"),
-    githubPath: path14.join(outputDir, "github-step-summary.md")
+    jsonPath: path16.join(outputDir, "gate-results.json"),
+    markdownPath: path16.join(outputDir, "gate-summary.md"),
+    htmlPath: path16.join(outputDir, "gate-report.html"),
+    junitPath: path16.join(outputDir, "junit.xml"),
+    githubPath: path16.join(outputDir, "github-step-summary.md")
   };
   await writeFile(
     paths.jsonPath,
@@ -11297,7 +11297,7 @@ async function gateCommand(options = {}) {
     const result = await runGate(runs, gateOptions);
     let artifacts;
     if (options.output !== void 0 && options.output.trim() !== "") {
-      artifacts = await writeArtifacts2(result, path14.resolve(options.output.trim()));
+      artifacts = await writeArtifacts2(result, path16.resolve(options.output.trim()));
     }
     if (options.json || format === "json") {
       console.log(JSON.stringify({ ...result, artifacts: artifacts ?? null }, null, 2));
@@ -11552,19 +11552,26 @@ function createCliProgram() {
       "openinference-json",
       "otlp-json"
     ])
-  ).option("--run <run-id>", "select a run when the trace contains multiple runs").option("--baseline <trace-path-or-run-id>", "optional baseline trace for diff artifacts").option("--baseline-run <run-id>", "select a run from the baseline trace").option("--github-summary <path>", "append a safe summary to this file, e.g. GITHUB_STEP_SUMMARY").option("--json", "print deterministic JSON manifest").action((target, opts) => {
+  ).option("--run <run-id>", "select a run when the trace contains multiple runs").option("--baseline <trace-path-or-run-id>", "optional baseline trace for diff artifacts").option("--baseline-run <run-id>", "select a run from the baseline trace").option("--github-summary <path>", "append a safe summary to this file, e.g. GITHUB_STEP_SUMMARY").option("--evidence", "write Evidence v2 package on failure (default behavior when omitted)").option("--no-evidence", "skip Evidence v2 package").option("--always-evidence", "write Evidence v2 package even when checks pass").option("--json", "print deterministic JSON manifest").action((target, opts) => {
     runCommand(() => artifactsCommand(target, opts));
   });
-  program.command("bundle").description("Create a share-safe offline trace bundle (local folder)").argument("[run-id]", "run id to bundle (optional with --session or --since)").option("--dir <path>", "trace directory for run/session lookup").option("--session <session-id>", "bundle all runs in a session").option("--since <duration>", "bundle runs with activity since a duration (e.g. 24h)").addOption(
+  const bundleCmd = program.command("bundle").description("Create or verify share-safe offline evidence bundles").argument("[run-id]", "run id to bundle (optional with --session or --since)").option("--dir <path>", "trace directory for run/session lookup").option("--session <session-id>", "bundle all runs in a session").option("--since <duration>", "bundle runs with activity since a duration (e.g. 24h)").addOption(
     new Option("--profile <profile>", "redaction profile for exported copies").choices(["local", "share", "strict"]).default("share")
   ).addOption(
     new Option(
       "--redaction-profile <profile>",
       "alias for --profile (canonical spelling)"
     ).choices(["local", "share", "strict"])
-  ).option("--out <path>", "output directory (folder; .zip suffix is stripped)").option("--output <path>", "alias for --out (canonical spelling)").option("--allow-unsafe", "write bundle even when verify-safe reports UNSAFE").option("--json", "print deterministic JSON manifest").action((runId, opts) => {
+  ).option("--out <path>", "output directory, .html path, or .zip path").option("--output <path>", "alias for --out (canonical spelling)").addOption(
+    new Option("--format <format>", "bundle output format").choices(["directory", "html", "zip"]).default("directory")
+  ).option("--allow-unsafe", "write bundle even when verify-safe reports UNSAFE").option("--json", "print deterministic JSON manifest").action((runId, opts) => {
     runCommand(() => bundleCommand(runId, opts));
   });
+  bundleCmd.command("verify").description("Verify Evidence v2 integrity (manifest, hashes, presence)").argument("<path>", "evidence/bundle directory containing evidence.json").addOption(
+    new Option("--unexpected <mode>", "policy for files not listed in the manifest").choices(["fail", "warn", "ignore"]).default("fail")
+  ).option("--json", "print deterministic JSON verify result").action((targetPath, opts) => {
+    runCommand(() => bundleVerifyCommand(targetPath, opts));
+  });
   program.command("ci-summary").description("Summarize local reporter artifact manifests for CI").argument("<manifest...>", "reporter artifact manifest JSON files").option("-o, --output <path>", "write Markdown summary to a local file").option("--github-summary <path>", "append Markdown summary to this local file, e.g. GITHUB_STEP_SUMMARY").option("--json", "print deterministic JSON summary").action((manifest, opts) => {
     runCommand(() => ciSummaryCommand(manifest, opts));
   });
@@ -11822,6 +11829,20 @@ function createCliProgram() {
   ).option("--format <format>", "markdown, json, or html", "markdown").option("-o, --output <dir>", "write cohort-results.json, cohort-summary.md, cohort-report.html").option("--json", "print deterministic JSON result").action((opts) => {
     runCommand(() => cohortCommand(opts));
   });
+  const mcpCmd = program.command("mcp").description("Configure local coding-agent MCP clients (read-only; dry-run by default)");
+  mcpCmd.command("configure").description("Print or write MCP client config for Cursor/Claude/Codex/Gemini").requiredOption(
+    "--client <name>",
+    "cursor | claude-code | codex | gemini"
+  ).option("--dir <path>", "trace directory for the MCP server", ".agent-inspect").option("--project-local", "target a project-local config path").option("--write", "write config (requires --project-local --yes)").option("--yes", "confirm write").option("--json", "print deterministic JSON result").action((opts) => {
+    runCommand(async () => {
+      if (!isMcpConfigureClient(opts.client)) {
+        throw new Error(
+          `Unsupported --client "${opts.client}". Use: cursor, claude-code, codex, gemini`
+        );
+      }
+      await mcpConfigureCommand({ ...opts, client: opts.client });
+    });
+  });
   program.command("gate").description("Run deterministic CI quality gates over traces or suites (v5.2+)").option("--dir <path>", "trace directory for threshold checks").option("--suite <path>", "suite config path").option("--max-error-rate <percent>", "maximum allowed error rate percentage").option("--max-p95-duration <ms>", "maximum allowed p95 run duration in ms").option("--forbid-tool <name>", "forbidden tool name (repeatable or comma-separated)").option(
     "--require-observation <name>",
     "required passed observation (repeatable or comma-separated)"
@@ -11838,9 +11859,9 @@ function isPrimaryModule() {
   if (!entry) return false;
   const selfPath = fileURLToPath(import.meta.url);
   try {
-    return realpathSync(path14.resolve(entry)) === realpathSync(path14.resolve(selfPath));
+    return realpathSync(path16.resolve(entry)) === realpathSync(path16.resolve(selfPath));
   } catch {
-    return path14.resolve(entry) === path14.resolve(selfPath);
+    return path16.resolve(entry) === path16.resolve(selfPath);
   }
 }
 if (isPrimaryModule()) {