agent-inspect 6.7.4 → 6.8.0

package/packages/cli/dist/index.mjs

@@ -1,6 +1,6 @@
 #!/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-FVEQ7JFF.mjs';
-import { realpathSync, constants as constants$1 } from 'fs';
+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-TO4VENHV.mjs';
+import { realpathSync, constants as constants$1, existsSync, readFileSync } from 'fs';
 import path14 from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { Command, Option } from 'commander';
@@ -11,7 +11,7 @@ import { createServer } from 'http';
 import { createRequire } from 'module';
 
 // package.json
-var version = "6.7.4";
+var version = "6.8.0";
 
 // packages/cli/src/trace-dir-scale.ts
 var TRACE_COUNT_WARN = 1e3;
@@ -2878,6 +2878,20 @@ ${attrsSection}
   };
 }
 
+// packages/cli/src/cli-option-aliases.ts
+function resolveOutputOption(options) {
+  const canonical = options.output?.trim();
+  if (canonical) return canonical;
+  const legacy = options.out?.trim();
+  return legacy || void 0;
+}
+function resolveRedactionProfileOption(options) {
+  const canonical = options.redactionProfile?.trim();
+  if (canonical) return canonical;
+  const legacy = options.profile?.trim();
+  return legacy || void 0;
+}
+
 // packages/cli/src/export.ts
 function parseRedactionProfile(s) {
   const v = (s ?? "local").trim().toLowerCase();
@@ -2908,7 +2922,7 @@ async function exportCommand(runId, options = {}) {
   let redactionProfile;
   try {
     format = parseExportFormat(options.format);
-    redactionProfile = parseRedactionProfile(options.redactionProfile);
+    redactionProfile = parseRedactionProfile(resolveRedactionProfileOption(options));
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(msg);
@@ -2956,7 +2970,8 @@ Trace directory: ${traceDir}`);
   if (validation !== void 0 && !validation.ok) {
     process.exitCode = 1;
   }
-  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path14.resolve(options.output.trim()) : void 0;
+  const resolvedOutput = resolveOutputOption(options);
+  const outPath = resolvedOutput !== void 0 ? path14.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
     await mkdir(path14.dirname(outPath), { recursive: true });
     await writeFile(outPath, result.content, "utf-8");
@@ -3793,7 +3808,7 @@ async function newestTraceMtimeMs(traceDir) {
 }
 async function loadSessionRuns(traceDir) {
   try {
-    const mod = await import('./src-I5NA7BLK.mjs');
+    const mod = await import('./src-Z5W27YCW.mjs');
     const dbPath = mod.resolveIndexDbPath(traceDir);
     const status = mod.indexStatus(dbPath);
     if (!status.healthy) {
@@ -4209,7 +4224,7 @@ async function reportCommand(runId, options = {}) {
   let redactionProfile;
   try {
     format = parseReportFormat(options.format);
-    redactionProfile = parseRedactionProfile2(options.redactionProfile);
+    redactionProfile = parseRedactionProfile2(resolveRedactionProfileOption(options));
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(msg);
@@ -4241,7 +4256,8 @@ async function reportCommand(runId, options = {}) {
     correlation: !options.noCorrelation,
     ...options.section ? { section: options.section } : {}
   });
-  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path14.resolve(options.output.trim()) : void 0;
+  const resolvedOutput = resolveOutputOption(options);
+  const outPath = resolvedOutput !== void 0 ? path14.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
     await mkdir(path14.dirname(outPath), { recursive: true });
     await writeFile(outPath, result.content, "utf-8");
@@ -4754,11 +4770,12 @@ function redactTraceContent(content, profile) {
   return redactDocument(content, profile);
 }
 async function redactCommand(target, options = {}, stdin = process.stdin) {
-  const profile = parseRedactionProfile3(options.profile);
+  const profile = parseRedactionProfile3(resolveRedactionProfileOption(options));
   const source = await contentFromTarget(target, options, stdin);
   const redacted = redactDocument(source.content, profile);
-  if (options.output !== void 0) {
-    await writeFile(options.output, redacted.content, "utf-8");
+  const outputPath = resolveOutputOption(options);
+  if (outputPath !== void 0) {
+    await writeFile(outputPath, redacted.content, "utf-8");
   }
   if (options.json) {
     console.log(
@@ -4767,9 +4784,9 @@ async function redactCommand(target, options = {}, stdin = process.stdin) {
           ok: true,
           profile,
           source: source.source,
-          output: options.output,
+          output: outputPath,
           findings: redacted.findings,
-          content: options.output === void 0 ? redacted.content : void 0
+          content: outputPath === void 0 ? redacted.content : void 0
         }),
         null,
         2
@@ -4777,7 +4794,7 @@ async function redactCommand(target, options = {}, stdin = process.stdin) {
     );
     return;
   }
-  if (options.output === void 0) {
+  if (outputPath === void 0) {
     process.stdout.write(redacted.content);
   }
 }
@@ -4854,7 +4871,7 @@ async function explainCommand(target, options = {}, stdin = process.stdin) {
   }
   let redactionProfile;
   try {
-    redactionProfile = parseRedactionProfile4(options.redactionProfile);
+    redactionProfile = parseRedactionProfile4(resolveRedactionProfileOption(options));
   } catch (error) {
     process.exitCode = 1;
     console.error(error instanceof Error ? error.message : String(error));
@@ -8794,8 +8811,9 @@ function safetyStatusFromAssess(status) {
   return "UNKNOWN";
 }
 async function resolveOutputDir(options, runIds, cwd) {
-  if (options.out !== void 0 && options.out.trim() !== "") {
-    const normalized = normalizeBundleOutputPath(options.out);
+  const out = resolveOutputOption(options);
+  if (out !== void 0) {
+    const normalized = normalizeBundleOutputPath(out);
     try {
       const location = resolveWorkspaceLocation(cwd);
       const manifest = await readWorkspaceManifestFile(location);
@@ -8865,7 +8883,7 @@ function extractHtmlBody(content) {
   return match?.[1]?.trim() ?? content;
 }
 async function bundleCommand(runIdArg, options = {}) {
-  const profile = parseBundleProfile(options.profile);
+  const profile = parseBundleProfile(resolveRedactionProfileOption(options));
   const traceDir = resolveTraceDir({ dir: options.dir });
   const cwd = process.cwd();
   let resolveResult;
@@ -9750,42 +9768,67 @@ async function traceDirWritable(traceDir) {
     };
   }
 }
-function resolvePackage(cwd, name) {
+function readPackageVersionNearEntry(entryPath, packageName) {
+  let dir = path14.dirname(path14.resolve(entryPath));
+  const { root } = path14.parse(dir);
+  while (true) {
+    const candidate = path14.join(dir, "package.json");
+    if (existsSync(candidate)) {
+      try {
+        const pkg = JSON.parse(readFileSync(candidate, "utf8"));
+        if (pkg.name === packageName && typeof pkg.version === "string") {
+          return pkg.version;
+        }
+      } catch {
+      }
+    }
+    if (dir === root) break;
+    const parent = path14.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return void 0;
+}
+function resolveInstalledPackage(cwd, name) {
   const require2 = createRequire(path14.join(cwd, "package.json"));
   try {
-    const pkgPath = require2.resolve(`${name}/package.json`);
-    const pkg = require2(pkgPath);
-    return { ok: true, version: pkg.version };
+    const entry = require2.resolve(name);
+    let version2;
+    try {
+      const pkgPath = require2.resolve(`${name}/package.json`);
+      const pkg = require2(pkgPath);
+      if (typeof pkg.version === "string") version2 = pkg.version;
+    } catch {
+      version2 = readPackageVersionNearEntry(entry, name);
+    }
+    return { ok: true, version: version2, entry };
   } catch {
     return { ok: false };
   }
 }
 function importSmoke(cwd) {
   const results = [];
-  const require2 = createRequire(path14.join(cwd, "package.json"));
-  try {
-    require2.resolve("agent-inspect");
+  const resolved = resolveInstalledPackage(cwd, "agent-inspect");
+  if (resolved.ok) {
     results.push({
       id: "import-agent-inspect",
       status: "pass",
-      message: "agent-inspect resolves from the current project."
+      message: "agent-inspect resolves from the current project.",
+      evidence: resolved.entry
     });
-  } catch {
+    results.push({
+      id: "import-agent-inspect-cjs",
+      status: "pass",
+      message: "CJS resolution for agent-inspect succeeded.",
+      evidence: resolved.entry
+    });
+  } else {
     results.push({
       id: "import-agent-inspect",
       status: "warn",
       message: "agent-inspect is not installed in the current project.",
       remediation: "Run npm install agent-inspect (or pnpm add agent-inspect)."
     });
-  }
-  try {
-    require2.resolve("agent-inspect/package.json");
-    results.push({
-      id: "import-agent-inspect-cjs",
-      status: "pass",
-      message: "CJS resolution for agent-inspect succeeded."
-    });
-  } catch {
     results.push({
       id: "import-agent-inspect-cjs",
       status: "skipped",
@@ -9803,7 +9846,7 @@ function optionalPackageChecks(cwd, framework) {
     "@agent-inspect/eval"
   ];
   return packages.map((name) => {
-    const resolved = resolvePackage(cwd, name);
+    const resolved = resolveInstalledPackage(cwd, name);
     if (!resolved.ok) {
       return {
         id: `optional-package-${name}`,
@@ -9821,7 +9864,7 @@ function optionalPackageChecks(cwd, framework) {
   });
 }
 function versionMismatchCheck(cwd) {
-  const root = resolvePackage(cwd, "agent-inspect");
+  const root = resolveInstalledPackage(cwd, "agent-inspect");
   if (!root.ok || root.version === void 0) {
     return {
       id: "version-alignment",
@@ -10380,7 +10423,7 @@ function isModuleNotFound4(e) {
 }
 async function loadIndexSqlite() {
   try {
-    return await import('./src-I5NA7BLK.mjs');
+    return await import('./src-Z5W27YCW.mjs');
   } catch (e) {
     if (isModuleNotFound4(e)) {
       console.error(
@@ -11169,11 +11212,17 @@ function createCliProgram() {
       "openinference",
       "otlp-json"
     ])
-  ).option("-o, --output <path>", "write export to file (creates parent dirs)").option("--json", "emit JSON wrapper about the export (includes content when writing to stdout)").option("--validate", "validate exported payload shape after generation").option("--include-attributes", "include bounded attributes (review before sharing)").option("--no-metadata", "omit summary / metadata sections").option("--no-errors", "omit error sections").addOption(
+  ).option("-o, --output <path>", "write export to file (creates parent dirs)").option("--out <path>", "alias for --output").option("--json", "emit JSON wrapper about the export (includes content when writing to stdout)").option("--validate", "validate exported payload shape after generation").option("--include-attributes", "include bounded attributes (review before sharing)").option("--no-metadata", "omit summary / metadata sections").option("--no-errors", "omit error sections").addOption(
     new Option(
       "--redaction-profile <profile>",
       "redaction profile for exported copies: local, share, strict (default: local)"
     ).choices(["local", "share", "strict"])
+  ).addOption(
+    new Option("--profile <profile>", "alias for --redaction-profile").choices([
+      "local",
+      "share",
+      "strict"
+    ])
   ).action((runId, opts) => {
     runCommand(() => exportCommand(runId, opts));
   });
@@ -11309,7 +11358,12 @@ function createCliProgram() {
   });
   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(
     new Option("--profile <profile>", "redaction profile for exported copies").choices(["local", "share", "strict"]).default("share")
-  ).option("--out <path>", "output directory (folder; .zip suffix is stripped)").option("--allow-unsafe", "write bundle even when verify-safe reports UNSAFE").option("--json", "print deterministic JSON manifest").action((runId, opts) => {
+  ).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) => {
     runCommand(() => bundleCommand(runId, 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) => {
@@ -11402,7 +11456,7 @@ function createCliProgram() {
       "markdown",
       "html"
     ])
-  ).option("-o, --output <path>", "write report to file (creates parent dirs)").option("--json", "emit JSON wrapper (includes content when writing to stdout)").option("--include-attributes", "include bounded step attributes in tree section").option("--no-errors", "omit error details from tree section").option("--no-correlation", "omit correlation metadata from what section").addOption(
+  ).option("-o, --output <path>", "write report to file (creates parent dirs)").option("--out <path>", "alias for --output").option("--json", "emit JSON wrapper (includes content when writing to stdout)").option("--include-attributes", "include bounded step attributes in tree section").option("--no-errors", "omit error details from tree section").option("--no-correlation", "omit correlation metadata from what section").addOption(
     new Option("--section <section>", "report section (default: all)").choices([
       "all",
       "observations",
@@ -11415,6 +11469,12 @@ function createCliProgram() {
       "--redaction-profile <profile>",
       "redaction profile for entire report: local, share, strict (default: local)"
     ).choices(["local", "share", "strict"])
+  ).addOption(
+    new Option("--profile <profile>", "alias for --redaction-profile").choices([
+      "local",
+      "share",
+      "strict"
+    ])
   ).action((runId, opts) => {
     runCommand(() => reportCommand(runId, opts));
   });
@@ -11423,7 +11483,12 @@ function createCliProgram() {
       "--profile <profile>",
       "redaction profile: local, share, strict (default: share)"
     ).choices(["local", "share", "strict"])
-  ).option("-o, --output <path>", "write redacted content to a file").option("--json", "print deterministic JSON wrapper with findings").action((target, opts) => {
+  ).addOption(
+    new Option(
+      "--redaction-profile <profile>",
+      "alias for --profile (canonical spelling)"
+    ).choices(["local", "share", "strict"])
+  ).option("-o, --output <path>", "write redacted content to a file").option("--out <path>", "alias for --output").option("--json", "print deterministic JSON wrapper with findings").action((target, opts) => {
     runCommand(() => redactCommand(target, opts));
   });
   program.command("explain").description("Explain a local trace with deterministic facts (no provider calls)").argument("<trace-path-or-run-id>", "trace file, directory, stdin -, or run id").option("--dir <path>", "trace directory for run-id lookup").addOption(
@@ -11440,6 +11505,12 @@ function createCliProgram() {
       "--redaction-profile <profile>",
       "redaction profile for explanation payload: local, share, strict (default: local)"
     ).choices(["local", "share", "strict"])
+  ).addOption(
+    new Option("--profile <profile>", "alias for --redaction-profile").choices([
+      "local",
+      "share",
+      "strict"
+    ])
   ).action((target, opts) => {
     runCommand(() => explainCommand(target, opts));
   });