@agent-inspect/jest 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentInspect contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,376 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var promises = require('fs/promises');
+var path = require('path');
+var reporters = require('agent-inspect/reporters');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// packages/jest/src/index.ts
+var PACKAGE_NAME = "@agent-inspect/jest";
+var DEFAULT_ARTIFACT_DIR = ".agent-inspect/jest-artifacts";
+var DEFAULT_SUCCESS_LIMIT = 20;
+var MAX_SUCCESS_LIMIT = 100;
+var MAX_TEXT = 180;
+var DEFAULT_GENERATED_AT = "1970-01-01T00:00:00.000Z";
+function createAgentInspectJestReporter(options = {}) {
+  const diagnostics = [];
+  const artifacts = [];
+  const seenKeys = /* @__PURE__ */ new Set();
+  const artifactNames = /* @__PURE__ */ new Map();
+  const successLimit = normalizeSuccessLimit(options);
+  let retainedSuccesses = 0;
+  const reporter = {
+    async onTestResult(_test, testResult) {
+      await handleFileResult(testResult);
+    },
+    async onRunComplete(_contexts, results) {
+      for (const fileResult of readRunResults(results)) {
+        await handleFileResult(fileResult);
+      }
+      await appendGithubSummary();
+    },
+    getDiagnostics() {
+      return diagnostics.slice();
+    },
+    getArtifacts() {
+      return artifacts.slice();
+    }
+  };
+  async function handleFileResult(testResult) {
+    for (const testCase of readTestCases(testResult)) {
+      await handleTestCase(testCase);
+    }
+  }
+  async function handleTestCase(testCase) {
+    const seenKey = `${testCase.id}:${testCase.status}`;
+    if (seenKeys.has(seenKey)) return;
+    const association = resolveAssociation(testCase, options);
+    if (association === void 0) return;
+    if (testCase.status === "passed") {
+      if (retainedSuccesses >= successLimit) return;
+      retainedSuccesses += 1;
+    }
+    seenKeys.add(seenKey);
+    try {
+      const artifact = await writeSafeArtifact({
+        artifactDir: options.artifactDir ?? DEFAULT_ARTIFACT_DIR,
+        association,
+        generatedAt: options.generatedAt ?? DEFAULT_GENERATED_AT,
+        redactionProfile: options.redactionProfile ?? "share",
+        reserveArtifactName,
+        status: testCase.status,
+        testCase
+      });
+      artifacts.push(artifact);
+    } catch (error) {
+      reportDiagnostic({
+        code: "artifact-write-failed",
+        message: `Could not write AgentInspect Jest artifact: ${errorMessage(error)}`,
+        testId: testCase.id
+      });
+    }
+  }
+  function reserveArtifactName(seed) {
+    const base = safeSegment(seed);
+    const next = (artifactNames.get(base) ?? 0) + 1;
+    artifactNames.set(base, next);
+    return next === 1 ? base : `${base}-${next}`;
+  }
+  function reportDiagnostic(diagnostic) {
+    diagnostics.push(diagnostic);
+    if (options.onDiagnostic === void 0) return;
+    try {
+      options.onDiagnostic(diagnostic);
+    } catch (error) {
+      diagnostics.push({
+        code: "on-diagnostic-failed",
+        message: `AgentInspect Jest diagnostic callback failed: ${errorMessage(error)}`,
+        testId: diagnostic.testId
+      });
+    }
+  }
+  async function appendGithubSummary() {
+    if (options.githubSummary === void 0 || artifacts.length === 0) return;
+    const failed = artifacts.filter((artifact) => artifact.status === "failed").length;
+    const passed = artifacts.filter((artifact) => artifact.status === "passed").length;
+    const lines = [
+      "",
+      "## AgentInspect Jest artifacts",
+      "",
+      `- Failed test artifacts: ${failed}`,
+      `- Passing test artifacts retained: ${passed}`,
+      `- Artifact directory: ${boundText(path__default.default.basename(options.artifactDir ?? DEFAULT_ARTIFACT_DIR))}`,
+      ""
+    ];
+    try {
+      await promises.writeFile(options.githubSummary, `${lines.join("\n")}
+`, { flag: "a" });
+    } catch (error) {
+      reportDiagnostic({
+        code: "github-summary-write-failed",
+        message: `Could not append AgentInspect Jest summary: ${errorMessage(error)}`
+      });
+    }
+  }
+  return reporter;
+}
+var AgentInspectJestReporter = class {
+  reporter;
+  constructor(_globalConfig, options = {}) {
+    this.reporter = createAgentInspectJestReporter(options);
+  }
+  async onTestResult(test, testResult, aggregatedResult) {
+    await this.reporter.onTestResult(test, testResult, aggregatedResult);
+  }
+  async onRunComplete(contexts, results) {
+    await this.reporter.onRunComplete(contexts, results);
+  }
+  getDiagnostics() {
+    return this.reporter.getDiagnostics();
+  }
+  getArtifacts() {
+    return this.reporter.getArtifacts();
+  }
+};
+var agentInspectJestReporter = createAgentInspectJestReporter;
+var index_default = AgentInspectJestReporter;
+function normalizeSuccessLimit(options) {
+  const cap = clampCount(options.maxSuccessfulTraces, DEFAULT_SUCCESS_LIMIT);
+  if (options.retainSuccessful === true) return cap;
+  if (typeof options.retainSuccessful === "number") {
+    return Math.min(clampCount(options.retainSuccessful, 0), cap);
+  }
+  return 0;
+}
+function clampCount(value, fallback) {
+  if (value === void 0 || !Number.isFinite(value)) return fallback;
+  return Math.max(0, Math.min(MAX_SUCCESS_LIMIT, Math.floor(value)));
+}
+function resolveAssociation(testCase, options) {
+  const resolved = options.resolveTrace?.(testCase);
+  if (isAssociation(resolved)) return resolved;
+  const explicit = resolveFromAssociationMap(testCase, options.associations);
+  if (explicit !== void 0) return explicit;
+  return readAssociationFromAssertion(testCase.raw);
+}
+function resolveFromAssociationMap(testCase, associations) {
+  if (associations === void 0) return void 0;
+  const basename = testCase.file === void 0 ? void 0 : path__default.default.basename(testCase.file);
+  const candidates = [
+    testCase.id,
+    testCase.fullName,
+    basename === void 0 ? void 0 : `${basename}::${testCase.fullName}`
+  ];
+  for (const candidate of candidates) {
+    if (candidate !== void 0 && isAssociation(associations[candidate])) {
+      return associations[candidate];
+    }
+  }
+  return void 0;
+}
+function readAssociationFromAssertion(assertion) {
+  if (!isObject(assertion)) return void 0;
+  const direct = readProp(assertion, "agentInspect");
+  if (isAssociation(direct)) return direct;
+  const meta = readProp(assertion, "meta");
+  if (!isObject(meta)) return void 0;
+  for (const candidate of [
+    readProp(meta, "agentInspect"),
+    readProp(meta, "agent-inspect"),
+    readProp(meta, "trace")
+  ]) {
+    if (isAssociation(candidate)) return candidate;
+  }
+  return void 0;
+}
+function isAssociation(value) {
+  if (!isObject(value)) return false;
+  return readOptionalString(value, "runId") !== void 0 || readOptionalString(value, "tracePath") !== void 0 || readOptionalString(value, "artifactLabel") !== void 0;
+}
+function readRunResults(results) {
+  if (!isObject(results)) return [];
+  const testResults = readProp(results, "testResults");
+  return Array.isArray(testResults) ? testResults : [];
+}
+function readTestCases(testResult) {
+  if (!isObject(testResult)) return [];
+  const result = testResult;
+  const file = readOptionalString(result, "testFilePath");
+  const assertions = Array.isArray(result.testResults) ? result.testResults : Array.isArray(result.assertionResults) ? result.assertionResults : [];
+  const cases = [];
+  for (const assertion of assertions) {
+    if (!isObject(assertion)) continue;
+    const status = readStatus(assertion);
+    if (status === void 0 || status === "skipped") continue;
+    const title = readOptionalString(assertion, "title") ?? "unknown-test";
+    const fullName = readFullName(assertion, title);
+    const id = `${file ?? "unknown-file"}::${fullName}`;
+    cases.push({
+      file,
+      fullName: boundText(redactText(fullName)),
+      id: boundText(redactText(id)),
+      raw: assertion,
+      status,
+      title: boundText(redactText(title))
+    });
+  }
+  return cases;
+}
+function readFullName(assertion, title) {
+  const explicit = readOptionalString(assertion, "fullName");
+  if (explicit !== void 0) return explicit;
+  const ancestors = Array.isArray(assertion.ancestorTitles) ? assertion.ancestorTitles.filter((item) => typeof item === "string") : [];
+  return [...ancestors, title].join(" ");
+}
+function readStatus(assertion) {
+  const raw = readOptionalString(assertion, "status");
+  if (raw === void 0) return void 0;
+  const normalized = raw.toLowerCase();
+  if (normalized === "failed" || normalized === "fail") return "failed";
+  if (normalized === "passed" || normalized === "pass") return "passed";
+  if (normalized === "pending" || normalized === "todo" || normalized === "skipped" || normalized === "skip" || normalized === "disabled") {
+    return "skipped";
+  }
+  return void 0;
+}
+async function writeSafeArtifact(input) {
+  const artifactSeed = input.association.artifactLabel ?? input.testCase.id ?? input.testCase.fullName ?? input.status;
+  const artifactName = input.reserveArtifactName(artifactSeed);
+  const testFile = input.testCase.file === void 0 ? void 0 : path__default.default.basename(input.testCase.file);
+  const safeTestId = `${testFile ?? "unknown-file"}::${input.testCase.fullName}`;
+  const manifestPathResult = reporters.createReporterArtifactPath({
+    outputDir: input.artifactDir,
+    testId: artifactName,
+    name: input.testCase.fullName,
+    file: testFile,
+    kind: "report",
+    format: "json"
+  });
+  const summaryPathResult = reporters.createReporterArtifactPath({
+    outputDir: input.artifactDir,
+    testId: artifactName,
+    name: input.testCase.fullName,
+    file: testFile,
+    kind: "summary",
+    format: "md"
+  });
+  if (!manifestPathResult.ok || manifestPathResult.absolutePath === void 0 || manifestPathResult.relativePath === void 0) {
+    throw new Error(formatPathDiagnostics(manifestPathResult.diagnostics));
+  }
+  if (!summaryPathResult.ok || summaryPathResult.absolutePath === void 0 || summaryPathResult.relativePath === void 0) {
+    throw new Error(formatPathDiagnostics(summaryPathResult.diagnostics));
+  }
+  const directory = path__default.default.dirname(manifestPathResult.absolutePath);
+  await promises.mkdir(directory, { recursive: true });
+  const traceFile = input.association.tracePath === void 0 ? void 0 : path__default.default.basename(input.association.tracePath);
+  const manifestArtifact = {
+    kind: "report",
+    path: manifestPathResult.relativePath,
+    format: "json",
+    redactionProfile: input.redactionProfile
+  };
+  const summaryArtifact = {
+    kind: "summary",
+    path: summaryPathResult.relativePath,
+    format: "md",
+    redactionProfile: input.redactionProfile
+  };
+  const manifest = reporters.createTraceArtifactManifest({
+    framework: "jest",
+    generatedAt: input.generatedAt,
+    results: [
+      {
+        testId: safeTestId,
+        name: input.testCase.fullName,
+        ...testFile === void 0 ? {} : { file: testFile },
+        status: input.status,
+        tracePath: safeOptional(traceFile),
+        artifacts: [manifestArtifact, summaryArtifact],
+        diagnostics: []
+      }
+    ],
+    artifacts: [manifestArtifact, summaryArtifact],
+    diagnostics: []
+  });
+  const trace = {
+    runId: safeOptional(input.association.runId),
+    file: safeOptional(traceFile)
+  };
+  await promises.writeFile(
+    manifestPathResult.absolutePath,
+    `${JSON.stringify({ package: PACKAGE_NAME, manifest, trace }, null, 2)}
+`
+  );
+  const summaryPath = summaryPathResult.absolutePath;
+  await promises.writeFile(summaryPath, renderSummary(manifest, trace), "utf-8");
+  return {
+    directory,
+    manifest,
+    manifestPath: manifestPathResult.absolutePath,
+    status: input.status,
+    summaryPath,
+    testId: safeTestId
+  };
+}
+function renderSummary(manifest, trace) {
+  const result = manifest.results[0];
+  return [
+    "# AgentInspect Jest Artifact",
+    "",
+    `- Test: ${result?.name ?? "unknown"}`,
+    `- Test id: ${result?.testId ?? "unknown"}`,
+    `- Status: ${result?.status ?? "unknown"}`,
+    `- File: ${result?.file ?? "unknown"}`,
+    `- Trace run: ${trace.runId ?? "unknown"}`,
+    `- Trace file: ${result?.tracePath ?? "unknown"}`,
+    `- Manifest schema: ${manifest.schemaVersion}`,
+    "",
+    "Trace contents are intentionally not embedded in this artifact.",
+    ""
+  ].join("\n");
+}
+function formatPathDiagnostics(diagnostics) {
+  if (diagnostics.length === 0) return "Unsafe AgentInspect Jest artifact path.";
+  return diagnostics.map((diagnostic) => diagnostic.message).join("; ");
+}
+function safeOptional(value) {
+  return value === void 0 ? void 0 : boundText(redactText(value));
+}
+function safeSegment(value) {
+  const sanitized = redactText(value).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+  return sanitized.length > 0 ? sanitized : "trace";
+}
+function boundText(value) {
+  const compact = value.replace(/\s+/g, " ").trim();
+  if (compact.length <= MAX_TEXT) return compact;
+  return `${compact.slice(0, MAX_TEXT - 12)}...[truncated]`;
+}
+function redactText(value) {
+  return value.replace(/\bsk-[A-Za-z0-9_-]{8,}\b/g, "[REDACTED]").replace(/\b(?:api[_-]?key|authorization|token|secret|password)\s*[:=]\s*[^,\s]+/gi, "$1=[REDACTED]");
+}
+function readOptionalString(value, key) {
+  if (!isObject(value)) return void 0;
+  const property = readProp(value, key);
+  return typeof property === "string" && property.length > 0 ? property : void 0;
+}
+function readProp(value, key) {
+  return value[key];
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+exports.AgentInspectJestReporter = AgentInspectJestReporter;
+exports.agentInspectJestReporter = agentInspectJestReporter;
+exports.createAgentInspectJestReporter = createAgentInspectJestReporter;
+exports.default = index_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["path","writeFile","createReporterArtifactPath","mkdir","createTraceArtifactManifest"],"mappings":"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","file":"index.cjs","sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  createReporterArtifactPath,\n  createTraceArtifactManifest,\n  type TraceArtifact,\n  type TraceArtifactManifest,\n  type TraceArtifactRedactionProfile,\n  type TraceReporterDiagnostic,\n} from \"agent-inspect/reporters\";\n\nexport type AgentInspectJestStatus = \"failed\" | \"passed\" | \"skipped\";\n\n/**\n * Experimental trace association read by `@agent-inspect/jest`.\n *\n * Jest does not expose Vitest-style task metadata, so the default path is an\n * explicit `associations` map keyed by test identity, or a `resolveTrace`\n * callback. The reporter never guesses by timestamps.\n */\nexport interface AgentInspectJestTraceAssociation {\n  /** AgentInspect run/span identifier to show in safe artifacts. */\n  readonly runId?: string;\n  /** Local trace file path. Only the basename is written to artifacts. */\n  readonly tracePath?: string;\n  /** Optional stable label for the artifact directory. */\n  readonly artifactLabel?: string;\n}\n\n/**\n * Experimental normalized view of one Jest assertion result.\n */\nexport interface AgentInspectJestTestCase {\n  readonly id: string;\n  readonly title: string;\n  readonly fullName: string;\n  readonly file?: string;\n  readonly status: AgentInspectJestStatus;\n  readonly raw: unknown;\n}\n\n/**\n * Experimental diagnostic emitted when reporter work cannot be completed.\n *\n * Diagnostics are reported instead of thrown so Jest's original test result\n * remains authoritative.\n */\nexport interface AgentInspectJestDiagnostic {\n  readonly code:\n    | \"artifact-write-failed\"\n    | \"github-summary-write-failed\"\n    | \"on-diagnostic-failed\";\n  readonly message: string;\n  readonly testId?: string;\n}\n\n/**\n * Experimental options for the AgentInspect Jest reporter.\n *\n * The reporter is local-only: it performs no network I/O and writes bounded,\n * structural artifacts without reading trace contents.\n */\nexport interface AgentInspectJestReporterOptions {\n  /** Directory for safe Jest artifacts. Defaults to `.agent-inspect/jest-artifacts`. */\n  readonly artifactDir?: string;\n  /** Optional GitHub step-summary path. Only bounded structural lines are appended. */\n  readonly githubSummary?: string;\n  /**\n   * Keep artifacts for passing tests. `false`/undefined keeps none; `true`\n   * keeps up to `maxSuccessfulTraces`; a number keeps up to that many.\n   */\n  readonly retainSuccessful?: boolean | number;\n  /** Upper bound for retained passing-test artifacts. Defaults to 20. */\n  readonly maxSuccessfulTraces?: number;\n  /** Redaction profile recorded on generated artifacts. Defaults to `share`. */\n  readonly redactionProfile?: TraceArtifactRedactionProfile;\n  /** Deterministic manifest timestamp. Defaults to the Unix epoch. */\n  readonly generatedAt?: string;\n  /** Explicit trace associations keyed by `file::fullName`, `basename::fullName`, or `fullName`. */\n  readonly associations?: Record<string, AgentInspectJestTraceAssociation>;\n  /** Resolve explicit test-to-trace associations from a normalized Jest case. */\n  readonly resolveTrace?: (\n    test: AgentInspectJestTestCase,\n  ) => AgentInspectJestTraceAssociation | undefined;\n  /** Observe non-fatal reporter diagnostics. */\n  readonly onDiagnostic?: (diagnostic: AgentInspectJestDiagnostic) => void;\n}\n\nexport interface AgentInspectJestArtifact {\n  readonly directory: string;\n  readonly manifestPath: string;\n  readonly summaryPath: string;\n  readonly status: AgentInspectJestStatus;\n  readonly testId: string;\n  readonly manifest: TraceArtifactManifest;\n}\n\n/**\n * Experimental Jest reporter facade.\n *\n * The hooks mirror Jest reporter lifecycle names, while inputs stay structural\n * to avoid a runtime dependency on Jest internals.\n */\nexport interface AgentInspectJestReporterFacade {\n  onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;\n  onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;\n  getDiagnostics(): readonly AgentInspectJestDiagnostic[];\n  getArtifacts(): readonly AgentInspectJestArtifact[];\n}\n\ntype AssertionResultLike = {\n  readonly ancestorTitles?: unknown;\n  readonly title?: unknown;\n  readonly fullName?: unknown;\n  readonly status?: unknown;\n  readonly meta?: unknown;\n  readonly agentInspect?: unknown;\n};\n\ntype TestFileResultLike = {\n  readonly testFilePath?: unknown;\n  readonly testResults?: unknown;\n  readonly assertionResults?: unknown;\n};\n\nconst PACKAGE_NAME = \"@agent-inspect/jest\";\nconst DEFAULT_ARTIFACT_DIR = \".agent-inspect/jest-artifacts\";\nconst DEFAULT_SUCCESS_LIMIT = 20;\nconst MAX_SUCCESS_LIMIT = 100;\nconst MAX_TEXT = 180;\nconst DEFAULT_GENERATED_AT = \"1970-01-01T00:00:00.000Z\";\n\n/**\n * Create the experimental AgentInspect Jest reporter.\n */\nexport function createAgentInspectJestReporter(\n  options: AgentInspectJestReporterOptions = {},\n): AgentInspectJestReporterFacade {\n  const diagnostics: AgentInspectJestDiagnostic[] = [];\n  const artifacts: AgentInspectJestArtifact[] = [];\n  const seenKeys = new Set<string>();\n  const artifactNames = new Map<string, number>();\n  const successLimit = normalizeSuccessLimit(options);\n  let retainedSuccesses = 0;\n\n  const reporter: AgentInspectJestReporterFacade = {\n    async onTestResult(_test: unknown, testResult: unknown): Promise<void> {\n      await handleFileResult(testResult);\n    },\n    async onRunComplete(_contexts?: unknown, results?: unknown): Promise<void> {\n      for (const fileResult of readRunResults(results)) {\n        await handleFileResult(fileResult);\n      }\n      await appendGithubSummary();\n    },\n    getDiagnostics(): readonly AgentInspectJestDiagnostic[] {\n      return diagnostics.slice();\n    },\n    getArtifacts(): readonly AgentInspectJestArtifact[] {\n      return artifacts.slice();\n    },\n  };\n\n  async function handleFileResult(testResult: unknown): Promise<void> {\n    for (const testCase of readTestCases(testResult)) {\n      await handleTestCase(testCase);\n    }\n  }\n\n  async function handleTestCase(testCase: AgentInspectJestTestCase): Promise<void> {\n    const seenKey = `${testCase.id}:${testCase.status}`;\n    if (seenKeys.has(seenKey)) return;\n\n    const association = resolveAssociation(testCase, options);\n    if (association === undefined) return;\n\n    if (testCase.status === \"passed\") {\n      if (retainedSuccesses >= successLimit) return;\n      retainedSuccesses += 1;\n    }\n\n    seenKeys.add(seenKey);\n\n    try {\n      const artifact = await writeSafeArtifact({\n        artifactDir: options.artifactDir ?? DEFAULT_ARTIFACT_DIR,\n        association,\n        generatedAt: options.generatedAt ?? DEFAULT_GENERATED_AT,\n        redactionProfile: options.redactionProfile ?? \"share\",\n        reserveArtifactName,\n        status: testCase.status,\n        testCase,\n      });\n      artifacts.push(artifact);\n    } catch (error) {\n      reportDiagnostic({\n        code: \"artifact-write-failed\",\n        message: `Could not write AgentInspect Jest artifact: ${errorMessage(error)}`,\n        testId: testCase.id,\n      });\n    }\n  }\n\n  function reserveArtifactName(seed: string): string {\n    const base = safeSegment(seed);\n    const next = (artifactNames.get(base) ?? 0) + 1;\n    artifactNames.set(base, next);\n    return next === 1 ? base : `${base}-${next}`;\n  }\n\n  function reportDiagnostic(diagnostic: AgentInspectJestDiagnostic): void {\n    diagnostics.push(diagnostic);\n    if (options.onDiagnostic === undefined) return;\n    try {\n      options.onDiagnostic(diagnostic);\n    } catch (error) {\n      diagnostics.push({\n        code: \"on-diagnostic-failed\",\n        message: `AgentInspect Jest diagnostic callback failed: ${errorMessage(error)}`,\n        testId: diagnostic.testId,\n      });\n    }\n  }\n\n  async function appendGithubSummary(): Promise<void> {\n    if (options.githubSummary === undefined || artifacts.length === 0) return;\n    const failed = artifacts.filter((artifact) => artifact.status === \"failed\").length;\n    const passed = artifacts.filter((artifact) => artifact.status === \"passed\").length;\n    const lines = [\n      \"\",\n      \"## AgentInspect Jest artifacts\",\n      \"\",\n      `- Failed test artifacts: ${failed}`,\n      `- Passing test artifacts retained: ${passed}`,\n      `- Artifact directory: ${boundText(path.basename(options.artifactDir ?? DEFAULT_ARTIFACT_DIR))}`,\n      \"\",\n    ];\n    try {\n      await writeFile(options.githubSummary, `${lines.join(\"\\n\")}\\n`, { flag: \"a\" });\n    } catch (error) {\n      reportDiagnostic({\n        code: \"github-summary-write-failed\",\n        message: `Could not append AgentInspect Jest summary: ${errorMessage(error)}`,\n      });\n    }\n  }\n\n  return reporter;\n}\n\n/**\n * Experimental Jest custom reporter class.\n */\nexport class AgentInspectJestReporter implements AgentInspectJestReporterFacade {\n  private readonly reporter: AgentInspectJestReporterFacade;\n\n  constructor(_globalConfig?: unknown, options: AgentInspectJestReporterOptions = {}) {\n    this.reporter = createAgentInspectJestReporter(options);\n  }\n\n  async onTestResult(\n    test: unknown,\n    testResult: unknown,\n    aggregatedResult?: unknown,\n  ): Promise<void> {\n    await this.reporter.onTestResult(test, testResult, aggregatedResult);\n  }\n\n  async onRunComplete(contexts?: unknown, results?: unknown): Promise<void> {\n    await this.reporter.onRunComplete(contexts, results);\n  }\n\n  getDiagnostics(): readonly AgentInspectJestDiagnostic[] {\n    return this.reporter.getDiagnostics();\n  }\n\n  getArtifacts(): readonly AgentInspectJestArtifact[] {\n    return this.reporter.getArtifacts();\n  }\n}\n\nexport const agentInspectJestReporter = createAgentInspectJestReporter;\nexport default AgentInspectJestReporter;\n\nfunction normalizeSuccessLimit(options: AgentInspectJestReporterOptions): number {\n  const cap = clampCount(options.maxSuccessfulTraces, DEFAULT_SUCCESS_LIMIT);\n  if (options.retainSuccessful === true) return cap;\n  if (typeof options.retainSuccessful === \"number\") {\n    return Math.min(clampCount(options.retainSuccessful, 0), cap);\n  }\n  return 0;\n}\n\nfunction clampCount(value: number | undefined, fallback: number): number {\n  if (value === undefined || !Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(MAX_SUCCESS_LIMIT, Math.floor(value)));\n}\n\nfunction resolveAssociation(\n  testCase: AgentInspectJestTestCase,\n  options: AgentInspectJestReporterOptions,\n): AgentInspectJestTraceAssociation | undefined {\n  const resolved = options.resolveTrace?.(testCase);\n  if (isAssociation(resolved)) return resolved;\n\n  const explicit = resolveFromAssociationMap(testCase, options.associations);\n  if (explicit !== undefined) return explicit;\n\n  return readAssociationFromAssertion(testCase.raw);\n}\n\nfunction resolveFromAssociationMap(\n  testCase: AgentInspectJestTestCase,\n  associations: Record<string, AgentInspectJestTraceAssociation> | undefined,\n): AgentInspectJestTraceAssociation | undefined {\n  if (associations === undefined) return undefined;\n  const basename = testCase.file === undefined ? undefined : path.basename(testCase.file);\n  const candidates = [\n    testCase.id,\n    testCase.fullName,\n    basename === undefined ? undefined : `${basename}::${testCase.fullName}`,\n  ];\n  for (const candidate of candidates) {\n    if (candidate !== undefined && isAssociation(associations[candidate])) {\n      return associations[candidate];\n    }\n  }\n  return undefined;\n}\n\nfunction readAssociationFromAssertion(\n  assertion: unknown,\n): AgentInspectJestTraceAssociation | undefined {\n  if (!isObject(assertion)) return undefined;\n  const direct = readProp(assertion, \"agentInspect\");\n  if (isAssociation(direct)) return direct;\n\n  const meta = readProp(assertion, \"meta\");\n  if (!isObject(meta)) return undefined;\n  for (const candidate of [\n    readProp(meta, \"agentInspect\"),\n    readProp(meta, \"agent-inspect\"),\n    readProp(meta, \"trace\"),\n  ]) {\n    if (isAssociation(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction isAssociation(\n  value: unknown,\n): value is AgentInspectJestTraceAssociation {\n  if (!isObject(value)) return false;\n  return (\n    readOptionalString(value, \"runId\") !== undefined ||\n    readOptionalString(value, \"tracePath\") !== undefined ||\n    readOptionalString(value, \"artifactLabel\") !== undefined\n  );\n}\n\nfunction readRunResults(results: unknown): unknown[] {\n  if (!isObject(results)) return [];\n  const testResults = readProp(results, \"testResults\");\n  return Array.isArray(testResults) ? testResults : [];\n}\n\nfunction readTestCases(testResult: unknown): AgentInspectJestTestCase[] {\n  if (!isObject(testResult)) return [];\n  const result = testResult as TestFileResultLike;\n  const file = readOptionalString(result, \"testFilePath\");\n  const assertions = Array.isArray(result.testResults)\n    ? result.testResults\n    : Array.isArray(result.assertionResults)\n      ? result.assertionResults\n      : [];\n\n  const cases: AgentInspectJestTestCase[] = [];\n  for (const assertion of assertions) {\n    if (!isObject(assertion)) continue;\n    const status = readStatus(assertion);\n    if (status === undefined || status === \"skipped\") continue;\n\n    const title = readOptionalString(assertion, \"title\") ?? \"unknown-test\";\n    const fullName = readFullName(assertion as AssertionResultLike, title);\n    const id = `${file ?? \"unknown-file\"}::${fullName}`;\n    cases.push({\n      file,\n      fullName: boundText(redactText(fullName)),\n      id: boundText(redactText(id)),\n      raw: assertion,\n      status,\n      title: boundText(redactText(title)),\n    });\n  }\n  return cases;\n}\n\nfunction readFullName(assertion: AssertionResultLike, title: string): string {\n  const explicit = readOptionalString(assertion, \"fullName\");\n  if (explicit !== undefined) return explicit;\n\n  const ancestors = Array.isArray(assertion.ancestorTitles)\n    ? assertion.ancestorTitles.filter((item): item is string => typeof item === \"string\")\n    : [];\n  return [...ancestors, title].join(\" \");\n}\n\nfunction readStatus(assertion: object): AgentInspectJestStatus | undefined {\n  const raw = readOptionalString(assertion, \"status\");\n  if (raw === undefined) return undefined;\n\n  const normalized = raw.toLowerCase();\n  if (normalized === \"failed\" || normalized === \"fail\") return \"failed\";\n  if (normalized === \"passed\" || normalized === \"pass\") return \"passed\";\n  if (\n    normalized === \"pending\" ||\n    normalized === \"todo\" ||\n    normalized === \"skipped\" ||\n    normalized === \"skip\" ||\n    normalized === \"disabled\"\n  ) {\n    return \"skipped\";\n  }\n  return undefined;\n}\n\nasync function writeSafeArtifact(input: {\n  readonly artifactDir: string;\n  readonly association: AgentInspectJestTraceAssociation;\n  readonly generatedAt: string;\n  readonly redactionProfile: TraceArtifactRedactionProfile;\n  readonly reserveArtifactName: (seed: string) => string;\n  readonly status: AgentInspectJestStatus;\n  readonly testCase: AgentInspectJestTestCase;\n}): Promise<AgentInspectJestArtifact> {\n  const artifactSeed =\n    input.association.artifactLabel ??\n    input.testCase.id ??\n    input.testCase.fullName ??\n    input.status;\n  const artifactName = input.reserveArtifactName(artifactSeed);\n  const testFile =\n    input.testCase.file === undefined ? undefined : path.basename(input.testCase.file);\n  const safeTestId = `${testFile ?? \"unknown-file\"}::${input.testCase.fullName}`;\n  const manifestPathResult = createReporterArtifactPath({\n    outputDir: input.artifactDir,\n    testId: artifactName,\n    name: input.testCase.fullName,\n    file: testFile,\n    kind: \"report\",\n    format: \"json\",\n  });\n  const summaryPathResult = createReporterArtifactPath({\n    outputDir: input.artifactDir,\n    testId: artifactName,\n    name: input.testCase.fullName,\n    file: testFile,\n    kind: \"summary\",\n    format: \"md\",\n  });\n\n  if (\n    !manifestPathResult.ok ||\n    manifestPathResult.absolutePath === undefined ||\n    manifestPathResult.relativePath === undefined\n  ) {\n    throw new Error(formatPathDiagnostics(manifestPathResult.diagnostics));\n  }\n  if (\n    !summaryPathResult.ok ||\n    summaryPathResult.absolutePath === undefined ||\n    summaryPathResult.relativePath === undefined\n  ) {\n    throw new Error(formatPathDiagnostics(summaryPathResult.diagnostics));\n  }\n\n  const directory = path.dirname(manifestPathResult.absolutePath);\n  await mkdir(directory, { recursive: true });\n\n  const traceFile =\n    input.association.tracePath === undefined\n      ? undefined\n      : path.basename(input.association.tracePath);\n  const manifestArtifact: TraceArtifact = {\n    kind: \"report\",\n    path: manifestPathResult.relativePath,\n    format: \"json\",\n    redactionProfile: input.redactionProfile,\n  };\n  const summaryArtifact: TraceArtifact = {\n    kind: \"summary\",\n    path: summaryPathResult.relativePath,\n    format: \"md\",\n    redactionProfile: input.redactionProfile,\n  };\n  const manifest = createTraceArtifactManifest({\n    framework: \"jest\",\n    generatedAt: input.generatedAt,\n    results: [\n      {\n        testId: safeTestId,\n        name: input.testCase.fullName,\n        ...(testFile === undefined ? {} : { file: testFile }),\n        status: input.status,\n        tracePath: safeOptional(traceFile),\n        artifacts: [manifestArtifact, summaryArtifact],\n        diagnostics: [],\n      },\n    ],\n    artifacts: [manifestArtifact, summaryArtifact],\n    diagnostics: [],\n  });\n  const trace = {\n    runId: safeOptional(input.association.runId),\n    file: safeOptional(traceFile),\n  };\n\n  await writeFile(\n    manifestPathResult.absolutePath,\n    `${JSON.stringify({ package: PACKAGE_NAME, manifest, trace }, null, 2)}\\n`,\n  );\n  const summaryPath = summaryPathResult.absolutePath;\n  await writeFile(summaryPath, renderSummary(manifest, trace), \"utf-8\");\n\n  return {\n    directory,\n    manifest,\n    manifestPath: manifestPathResult.absolutePath,\n    status: input.status,\n    summaryPath,\n    testId: safeTestId,\n  };\n}\n\nfunction renderSummary(\n  manifest: TraceArtifactManifest,\n  trace: { readonly runId?: string; readonly file?: string },\n): string {\n  const result = manifest.results[0];\n  return [\n    \"# AgentInspect Jest Artifact\",\n    \"\",\n    `- Test: ${result?.name ?? \"unknown\"}`,\n    `- Test id: ${result?.testId ?? \"unknown\"}`,\n    `- Status: ${result?.status ?? \"unknown\"}`,\n    `- File: ${result?.file ?? \"unknown\"}`,\n    `- Trace run: ${trace.runId ?? \"unknown\"}`,\n    `- Trace file: ${result?.tracePath ?? \"unknown\"}`,\n    `- Manifest schema: ${manifest.schemaVersion}`,\n    \"\",\n    \"Trace contents are intentionally not embedded in this artifact.\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nfunction formatPathDiagnostics(\n  diagnostics: readonly TraceReporterDiagnostic[],\n): string {\n  if (diagnostics.length === 0) return \"Unsafe AgentInspect Jest artifact path.\";\n  return diagnostics.map((diagnostic) => diagnostic.message).join(\"; \");\n}\n\nfunction safeOptional(value: string | undefined): string | undefined {\n  return value === undefined ? undefined : boundText(redactText(value));\n}\n\nfunction safeSegment(value: string): string {\n  const sanitized = redactText(value)\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 80);\n  return sanitized.length > 0 ? sanitized : \"trace\";\n}\n\nfunction boundText(value: string): string {\n  const compact = value.replace(/\\s+/g, \" \").trim();\n  if (compact.length <= MAX_TEXT) return compact;\n  return `${compact.slice(0, MAX_TEXT - 12)}...[truncated]`;\n}\n\nfunction redactText(value: string): string {\n  return value\n    .replace(/\\bsk-[A-Za-z0-9_-]{8,}\\b/g, \"[REDACTED]\")\n    .replace(/\\b(?:api[_-]?key|authorization|token|secret|password)\\s*[:=]\\s*[^,\\s]+/gi, \"$1=[REDACTED]\");\n}\n\nfunction readOptionalString(value: unknown, key: string): string | undefined {\n  if (!isObject(value)) return undefined;\n  const property = readProp(value, key);\n  return typeof property === \"string\" && property.length > 0 ? property : undefined;\n}\n\nfunction readProp(value: object, key: string): unknown {\n  return (value as Record<string, unknown>)[key];\n}\n\nfunction isObject(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,158 @@
+declare const TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION: "0.1";
+/** Experimental reporter framework identifier for local CI artifacts. */
+type TraceReporterFramework = "vitest" | "jest" | "manual";
+/** Experimental reporter test status normalized across supported test runners. */
+type TraceTestStatus = "passed" | "failed" | "skipped" | "todo";
+/** Experimental reporter artifact kind used in artifact manifests. */
+type TraceArtifactKind = "trace" | "report" | "eval" | "redaction" | "summary";
+/** Experimental reporter artifact file format used in artifact manifests. */
+type TraceArtifactFormat = "json" | "jsonl" | "md" | "html";
+/** Experimental redaction profile marker recorded with reporter artifacts. */
+type TraceArtifactRedactionProfile = "local" | "share" | "strict";
+/** Experimental reporter diagnostic severity. */
+type TraceReporterDiagnosticSeverity = "info" | "warning" | "error";
+/** Experimental reporter diagnostic code for safe, non-throwing reporter helpers. */
+type TraceReporterDiagnosticCode = "invalid_artifact_path" | "artifact_path_escape" | "artifact_path_empty" | "artifact_path_absolute" | "reporter_failure";
+/** Experimental diagnostic emitted by reporter helpers instead of throwing. */
+interface TraceReporterDiagnostic {
+    code: TraceReporterDiagnosticCode;
+    severity: TraceReporterDiagnosticSeverity;
+    message: string;
+    target?: string;
+}
+/** Experimental manifest artifact entry shared by framework reporters. */
+interface TraceArtifact {
+    kind: TraceArtifactKind;
+    path: string;
+    format: TraceArtifactFormat;
+    redactionProfile: TraceArtifactRedactionProfile;
+    title?: string;
+    sizeBytes?: number;
+    diagnostics?: TraceReporterDiagnostic[];
+}
+/** Experimental normalized test result entry shared by framework reporters. */
+interface TraceTestResult {
+    testId: string;
+    name: string;
+    file?: string;
+    status: TraceTestStatus;
+    durationMs?: number;
+    tracePath?: string;
+    artifacts?: TraceArtifact[];
+    diagnostics?: TraceReporterDiagnostic[];
+}
+/** Experimental reporter artifact manifest shared by framework reporters. */
+interface TraceArtifactManifest {
+    schemaVersion: typeof TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION;
+    generatedAt: string;
+    framework: TraceReporterFramework;
+    results: TraceTestResult[];
+    artifacts: TraceArtifact[];
+    diagnostics: TraceReporterDiagnostic[];
+}
+
+type AgentInspectJestStatus = "failed" | "passed" | "skipped";
+/**
+ * Experimental trace association read by `@agent-inspect/jest`.
+ *
+ * Jest does not expose Vitest-style task metadata, so the default path is an
+ * explicit `associations` map keyed by test identity, or a `resolveTrace`
+ * callback. The reporter never guesses by timestamps.
+ */
+interface AgentInspectJestTraceAssociation {
+    /** AgentInspect run/span identifier to show in safe artifacts. */
+    readonly runId?: string;
+    /** Local trace file path. Only the basename is written to artifacts. */
+    readonly tracePath?: string;
+    /** Optional stable label for the artifact directory. */
+    readonly artifactLabel?: string;
+}
+/**
+ * Experimental normalized view of one Jest assertion result.
+ */
+interface AgentInspectJestTestCase {
+    readonly id: string;
+    readonly title: string;
+    readonly fullName: string;
+    readonly file?: string;
+    readonly status: AgentInspectJestStatus;
+    readonly raw: unknown;
+}
+/**
+ * Experimental diagnostic emitted when reporter work cannot be completed.
+ *
+ * Diagnostics are reported instead of thrown so Jest's original test result
+ * remains authoritative.
+ */
+interface AgentInspectJestDiagnostic {
+    readonly code: "artifact-write-failed" | "github-summary-write-failed" | "on-diagnostic-failed";
+    readonly message: string;
+    readonly testId?: string;
+}
+/**
+ * Experimental options for the AgentInspect Jest reporter.
+ *
+ * The reporter is local-only: it performs no network I/O and writes bounded,
+ * structural artifacts without reading trace contents.
+ */
+interface AgentInspectJestReporterOptions {
+    /** Directory for safe Jest artifacts. Defaults to `.agent-inspect/jest-artifacts`. */
+    readonly artifactDir?: string;
+    /** Optional GitHub step-summary path. Only bounded structural lines are appended. */
+    readonly githubSummary?: string;
+    /**
+     * Keep artifacts for passing tests. `false`/undefined keeps none; `true`
+     * keeps up to `maxSuccessfulTraces`; a number keeps up to that many.
+     */
+    readonly retainSuccessful?: boolean | number;
+    /** Upper bound for retained passing-test artifacts. Defaults to 20. */
+    readonly maxSuccessfulTraces?: number;
+    /** Redaction profile recorded on generated artifacts. Defaults to `share`. */
+    readonly redactionProfile?: TraceArtifactRedactionProfile;
+    /** Deterministic manifest timestamp. Defaults to the Unix epoch. */
+    readonly generatedAt?: string;
+    /** Explicit trace associations keyed by `file::fullName`, `basename::fullName`, or `fullName`. */
+    readonly associations?: Record<string, AgentInspectJestTraceAssociation>;
+    /** Resolve explicit test-to-trace associations from a normalized Jest case. */
+    readonly resolveTrace?: (test: AgentInspectJestTestCase) => AgentInspectJestTraceAssociation | undefined;
+    /** Observe non-fatal reporter diagnostics. */
+    readonly onDiagnostic?: (diagnostic: AgentInspectJestDiagnostic) => void;
+}
+interface AgentInspectJestArtifact {
+    readonly directory: string;
+    readonly manifestPath: string;
+    readonly summaryPath: string;
+    readonly status: AgentInspectJestStatus;
+    readonly testId: string;
+    readonly manifest: TraceArtifactManifest;
+}
+/**
+ * Experimental Jest reporter facade.
+ *
+ * The hooks mirror Jest reporter lifecycle names, while inputs stay structural
+ * to avoid a runtime dependency on Jest internals.
+ */
+interface AgentInspectJestReporterFacade {
+    onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;
+    onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;
+    getDiagnostics(): readonly AgentInspectJestDiagnostic[];
+    getArtifacts(): readonly AgentInspectJestArtifact[];
+}
+/**
+ * Create the experimental AgentInspect Jest reporter.
+ */
+declare function createAgentInspectJestReporter(options?: AgentInspectJestReporterOptions): AgentInspectJestReporterFacade;
+/**
+ * Experimental Jest custom reporter class.
+ */
+declare class AgentInspectJestReporter implements AgentInspectJestReporterFacade {
+    private readonly reporter;
+    constructor(_globalConfig?: unknown, options?: AgentInspectJestReporterOptions);
+    onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;
+    onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;
+    getDiagnostics(): readonly AgentInspectJestDiagnostic[];
+    getArtifacts(): readonly AgentInspectJestArtifact[];
+}
+declare const agentInspectJestReporter: typeof createAgentInspectJestReporter;
+
+export { type AgentInspectJestArtifact, type AgentInspectJestDiagnostic, AgentInspectJestReporter, type AgentInspectJestReporterFacade, type AgentInspectJestReporterOptions, type AgentInspectJestStatus, type AgentInspectJestTestCase, type AgentInspectJestTraceAssociation, agentInspectJestReporter, createAgentInspectJestReporter, AgentInspectJestReporter as default };

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+declare const TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION: "0.1";
+/** Experimental reporter framework identifier for local CI artifacts. */
+type TraceReporterFramework = "vitest" | "jest" | "manual";
+/** Experimental reporter test status normalized across supported test runners. */
+type TraceTestStatus = "passed" | "failed" | "skipped" | "todo";
+/** Experimental reporter artifact kind used in artifact manifests. */
+type TraceArtifactKind = "trace" | "report" | "eval" | "redaction" | "summary";
+/** Experimental reporter artifact file format used in artifact manifests. */
+type TraceArtifactFormat = "json" | "jsonl" | "md" | "html";
+/** Experimental redaction profile marker recorded with reporter artifacts. */
+type TraceArtifactRedactionProfile = "local" | "share" | "strict";
+/** Experimental reporter diagnostic severity. */
+type TraceReporterDiagnosticSeverity = "info" | "warning" | "error";
+/** Experimental reporter diagnostic code for safe, non-throwing reporter helpers. */
+type TraceReporterDiagnosticCode = "invalid_artifact_path" | "artifact_path_escape" | "artifact_path_empty" | "artifact_path_absolute" | "reporter_failure";
+/** Experimental diagnostic emitted by reporter helpers instead of throwing. */
+interface TraceReporterDiagnostic {
+    code: TraceReporterDiagnosticCode;
+    severity: TraceReporterDiagnosticSeverity;
+    message: string;
+    target?: string;
+}
+/** Experimental manifest artifact entry shared by framework reporters. */
+interface TraceArtifact {
+    kind: TraceArtifactKind;
+    path: string;
+    format: TraceArtifactFormat;
+    redactionProfile: TraceArtifactRedactionProfile;
+    title?: string;
+    sizeBytes?: number;
+    diagnostics?: TraceReporterDiagnostic[];
+}
+/** Experimental normalized test result entry shared by framework reporters. */
+interface TraceTestResult {
+    testId: string;
+    name: string;
+    file?: string;
+    status: TraceTestStatus;
+    durationMs?: number;
+    tracePath?: string;
+    artifacts?: TraceArtifact[];
+    diagnostics?: TraceReporterDiagnostic[];
+}
+/** Experimental reporter artifact manifest shared by framework reporters. */
+interface TraceArtifactManifest {
+    schemaVersion: typeof TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION;
+    generatedAt: string;
+    framework: TraceReporterFramework;
+    results: TraceTestResult[];
+    artifacts: TraceArtifact[];
+    diagnostics: TraceReporterDiagnostic[];
+}
+
+type AgentInspectJestStatus = "failed" | "passed" | "skipped";
+/**
+ * Experimental trace association read by `@agent-inspect/jest`.
+ *
+ * Jest does not expose Vitest-style task metadata, so the default path is an
+ * explicit `associations` map keyed by test identity, or a `resolveTrace`
+ * callback. The reporter never guesses by timestamps.
+ */
+interface AgentInspectJestTraceAssociation {
+    /** AgentInspect run/span identifier to show in safe artifacts. */
+    readonly runId?: string;
+    /** Local trace file path. Only the basename is written to artifacts. */
+    readonly tracePath?: string;
+    /** Optional stable label for the artifact directory. */
+    readonly artifactLabel?: string;
+}
+/**
+ * Experimental normalized view of one Jest assertion result.
+ */
+interface AgentInspectJestTestCase {
+    readonly id: string;
+    readonly title: string;
+    readonly fullName: string;
+    readonly file?: string;
+    readonly status: AgentInspectJestStatus;
+    readonly raw: unknown;
+}
+/**
+ * Experimental diagnostic emitted when reporter work cannot be completed.
+ *
+ * Diagnostics are reported instead of thrown so Jest's original test result
+ * remains authoritative.
+ */
+interface AgentInspectJestDiagnostic {
+    readonly code: "artifact-write-failed" | "github-summary-write-failed" | "on-diagnostic-failed";
+    readonly message: string;
+    readonly testId?: string;
+}
+/**
+ * Experimental options for the AgentInspect Jest reporter.
+ *
+ * The reporter is local-only: it performs no network I/O and writes bounded,
+ * structural artifacts without reading trace contents.
+ */
+interface AgentInspectJestReporterOptions {
+    /** Directory for safe Jest artifacts. Defaults to `.agent-inspect/jest-artifacts`. */
+    readonly artifactDir?: string;
+    /** Optional GitHub step-summary path. Only bounded structural lines are appended. */
+    readonly githubSummary?: string;
+    /**
+     * Keep artifacts for passing tests. `false`/undefined keeps none; `true`
+     * keeps up to `maxSuccessfulTraces`; a number keeps up to that many.
+     */
+    readonly retainSuccessful?: boolean | number;
+    /** Upper bound for retained passing-test artifacts. Defaults to 20. */
+    readonly maxSuccessfulTraces?: number;
+    /** Redaction profile recorded on generated artifacts. Defaults to `share`. */
+    readonly redactionProfile?: TraceArtifactRedactionProfile;
+    /** Deterministic manifest timestamp. Defaults to the Unix epoch. */
+    readonly generatedAt?: string;
+    /** Explicit trace associations keyed by `file::fullName`, `basename::fullName`, or `fullName`. */
+    readonly associations?: Record<string, AgentInspectJestTraceAssociation>;
+    /** Resolve explicit test-to-trace associations from a normalized Jest case. */
+    readonly resolveTrace?: (test: AgentInspectJestTestCase) => AgentInspectJestTraceAssociation | undefined;
+    /** Observe non-fatal reporter diagnostics. */
+    readonly onDiagnostic?: (diagnostic: AgentInspectJestDiagnostic) => void;
+}
+interface AgentInspectJestArtifact {
+    readonly directory: string;
+    readonly manifestPath: string;
+    readonly summaryPath: string;
+    readonly status: AgentInspectJestStatus;
+    readonly testId: string;
+    readonly manifest: TraceArtifactManifest;
+}
+/**
+ * Experimental Jest reporter facade.
+ *
+ * The hooks mirror Jest reporter lifecycle names, while inputs stay structural
+ * to avoid a runtime dependency on Jest internals.
+ */
+interface AgentInspectJestReporterFacade {
+    onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;
+    onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;
+    getDiagnostics(): readonly AgentInspectJestDiagnostic[];
+    getArtifacts(): readonly AgentInspectJestArtifact[];
+}
+/**
+ * Create the experimental AgentInspect Jest reporter.
+ */
+declare function createAgentInspectJestReporter(options?: AgentInspectJestReporterOptions): AgentInspectJestReporterFacade;
+/**
+ * Experimental Jest custom reporter class.
+ */
+declare class AgentInspectJestReporter implements AgentInspectJestReporterFacade {
+    private readonly reporter;
+    constructor(_globalConfig?: unknown, options?: AgentInspectJestReporterOptions);
+    onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;
+    onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;
+    getDiagnostics(): readonly AgentInspectJestDiagnostic[];
+    getArtifacts(): readonly AgentInspectJestArtifact[];
+}
+declare const agentInspectJestReporter: typeof createAgentInspectJestReporter;
+
+export { type AgentInspectJestArtifact, type AgentInspectJestDiagnostic, AgentInspectJestReporter, type AgentInspectJestReporterFacade, type AgentInspectJestReporterOptions, type AgentInspectJestStatus, type AgentInspectJestTestCase, type AgentInspectJestTraceAssociation, agentInspectJestReporter, createAgentInspectJestReporter, AgentInspectJestReporter as default };

package/dist/index.mjs

@@ -0,0 +1,365 @@
+import { writeFile, mkdir } from 'fs/promises';
+import path from 'path';
+import { createReporterArtifactPath, createTraceArtifactManifest } from 'agent-inspect/reporters';
+
+// packages/jest/src/index.ts
+var PACKAGE_NAME = "@agent-inspect/jest";
+var DEFAULT_ARTIFACT_DIR = ".agent-inspect/jest-artifacts";
+var DEFAULT_SUCCESS_LIMIT = 20;
+var MAX_SUCCESS_LIMIT = 100;
+var MAX_TEXT = 180;
+var DEFAULT_GENERATED_AT = "1970-01-01T00:00:00.000Z";
+function createAgentInspectJestReporter(options = {}) {
+  const diagnostics = [];
+  const artifacts = [];
+  const seenKeys = /* @__PURE__ */ new Set();
+  const artifactNames = /* @__PURE__ */ new Map();
+  const successLimit = normalizeSuccessLimit(options);
+  let retainedSuccesses = 0;
+  const reporter = {
+    async onTestResult(_test, testResult) {
+      await handleFileResult(testResult);
+    },
+    async onRunComplete(_contexts, results) {
+      for (const fileResult of readRunResults(results)) {
+        await handleFileResult(fileResult);
+      }
+      await appendGithubSummary();
+    },
+    getDiagnostics() {
+      return diagnostics.slice();
+    },
+    getArtifacts() {
+      return artifacts.slice();
+    }
+  };
+  async function handleFileResult(testResult) {
+    for (const testCase of readTestCases(testResult)) {
+      await handleTestCase(testCase);
+    }
+  }
+  async function handleTestCase(testCase) {
+    const seenKey = `${testCase.id}:${testCase.status}`;
+    if (seenKeys.has(seenKey)) return;
+    const association = resolveAssociation(testCase, options);
+    if (association === void 0) return;
+    if (testCase.status === "passed") {
+      if (retainedSuccesses >= successLimit) return;
+      retainedSuccesses += 1;
+    }
+    seenKeys.add(seenKey);
+    try {
+      const artifact = await writeSafeArtifact({
+        artifactDir: options.artifactDir ?? DEFAULT_ARTIFACT_DIR,
+        association,
+        generatedAt: options.generatedAt ?? DEFAULT_GENERATED_AT,
+        redactionProfile: options.redactionProfile ?? "share",
+        reserveArtifactName,
+        status: testCase.status,
+        testCase
+      });
+      artifacts.push(artifact);
+    } catch (error) {
+      reportDiagnostic({
+        code: "artifact-write-failed",
+        message: `Could not write AgentInspect Jest artifact: ${errorMessage(error)}`,
+        testId: testCase.id
+      });
+    }
+  }
+  function reserveArtifactName(seed) {
+    const base = safeSegment(seed);
+    const next = (artifactNames.get(base) ?? 0) + 1;
+    artifactNames.set(base, next);
+    return next === 1 ? base : `${base}-${next}`;
+  }
+  function reportDiagnostic(diagnostic) {
+    diagnostics.push(diagnostic);
+    if (options.onDiagnostic === void 0) return;
+    try {
+      options.onDiagnostic(diagnostic);
+    } catch (error) {
+      diagnostics.push({
+        code: "on-diagnostic-failed",
+        message: `AgentInspect Jest diagnostic callback failed: ${errorMessage(error)}`,
+        testId: diagnostic.testId
+      });
+    }
+  }
+  async function appendGithubSummary() {
+    if (options.githubSummary === void 0 || artifacts.length === 0) return;
+    const failed = artifacts.filter((artifact) => artifact.status === "failed").length;
+    const passed = artifacts.filter((artifact) => artifact.status === "passed").length;
+    const lines = [
+      "",
+      "## AgentInspect Jest artifacts",
+      "",
+      `- Failed test artifacts: ${failed}`,
+      `- Passing test artifacts retained: ${passed}`,
+      `- Artifact directory: ${boundText(path.basename(options.artifactDir ?? DEFAULT_ARTIFACT_DIR))}`,
+      ""
+    ];
+    try {
+      await writeFile(options.githubSummary, `${lines.join("\n")}
+`, { flag: "a" });
+    } catch (error) {
+      reportDiagnostic({
+        code: "github-summary-write-failed",
+        message: `Could not append AgentInspect Jest summary: ${errorMessage(error)}`
+      });
+    }
+  }
+  return reporter;
+}
+var AgentInspectJestReporter = class {
+  reporter;
+  constructor(_globalConfig, options = {}) {
+    this.reporter = createAgentInspectJestReporter(options);
+  }
+  async onTestResult(test, testResult, aggregatedResult) {
+    await this.reporter.onTestResult(test, testResult, aggregatedResult);
+  }
+  async onRunComplete(contexts, results) {
+    await this.reporter.onRunComplete(contexts, results);
+  }
+  getDiagnostics() {
+    return this.reporter.getDiagnostics();
+  }
+  getArtifacts() {
+    return this.reporter.getArtifacts();
+  }
+};
+var agentInspectJestReporter = createAgentInspectJestReporter;
+var index_default = AgentInspectJestReporter;
+function normalizeSuccessLimit(options) {
+  const cap = clampCount(options.maxSuccessfulTraces, DEFAULT_SUCCESS_LIMIT);
+  if (options.retainSuccessful === true) return cap;
+  if (typeof options.retainSuccessful === "number") {
+    return Math.min(clampCount(options.retainSuccessful, 0), cap);
+  }
+  return 0;
+}
+function clampCount(value, fallback) {
+  if (value === void 0 || !Number.isFinite(value)) return fallback;
+  return Math.max(0, Math.min(MAX_SUCCESS_LIMIT, Math.floor(value)));
+}
+function resolveAssociation(testCase, options) {
+  const resolved = options.resolveTrace?.(testCase);
+  if (isAssociation(resolved)) return resolved;
+  const explicit = resolveFromAssociationMap(testCase, options.associations);
+  if (explicit !== void 0) return explicit;
+  return readAssociationFromAssertion(testCase.raw);
+}
+function resolveFromAssociationMap(testCase, associations) {
+  if (associations === void 0) return void 0;
+  const basename = testCase.file === void 0 ? void 0 : path.basename(testCase.file);
+  const candidates = [
+    testCase.id,
+    testCase.fullName,
+    basename === void 0 ? void 0 : `${basename}::${testCase.fullName}`
+  ];
+  for (const candidate of candidates) {
+    if (candidate !== void 0 && isAssociation(associations[candidate])) {
+      return associations[candidate];
+    }
+  }
+  return void 0;
+}
+function readAssociationFromAssertion(assertion) {
+  if (!isObject(assertion)) return void 0;
+  const direct = readProp(assertion, "agentInspect");
+  if (isAssociation(direct)) return direct;
+  const meta = readProp(assertion, "meta");
+  if (!isObject(meta)) return void 0;
+  for (const candidate of [
+    readProp(meta, "agentInspect"),
+    readProp(meta, "agent-inspect"),
+    readProp(meta, "trace")
+  ]) {
+    if (isAssociation(candidate)) return candidate;
+  }
+  return void 0;
+}
+function isAssociation(value) {
+  if (!isObject(value)) return false;
+  return readOptionalString(value, "runId") !== void 0 || readOptionalString(value, "tracePath") !== void 0 || readOptionalString(value, "artifactLabel") !== void 0;
+}
+function readRunResults(results) {
+  if (!isObject(results)) return [];
+  const testResults = readProp(results, "testResults");
+  return Array.isArray(testResults) ? testResults : [];
+}
+function readTestCases(testResult) {
+  if (!isObject(testResult)) return [];
+  const result = testResult;
+  const file = readOptionalString(result, "testFilePath");
+  const assertions = Array.isArray(result.testResults) ? result.testResults : Array.isArray(result.assertionResults) ? result.assertionResults : [];
+  const cases = [];
+  for (const assertion of assertions) {
+    if (!isObject(assertion)) continue;
+    const status = readStatus(assertion);
+    if (status === void 0 || status === "skipped") continue;
+    const title = readOptionalString(assertion, "title") ?? "unknown-test";
+    const fullName = readFullName(assertion, title);
+    const id = `${file ?? "unknown-file"}::${fullName}`;
+    cases.push({
+      file,
+      fullName: boundText(redactText(fullName)),
+      id: boundText(redactText(id)),
+      raw: assertion,
+      status,
+      title: boundText(redactText(title))
+    });
+  }
+  return cases;
+}
+function readFullName(assertion, title) {
+  const explicit = readOptionalString(assertion, "fullName");
+  if (explicit !== void 0) return explicit;
+  const ancestors = Array.isArray(assertion.ancestorTitles) ? assertion.ancestorTitles.filter((item) => typeof item === "string") : [];
+  return [...ancestors, title].join(" ");
+}
+function readStatus(assertion) {
+  const raw = readOptionalString(assertion, "status");
+  if (raw === void 0) return void 0;
+  const normalized = raw.toLowerCase();
+  if (normalized === "failed" || normalized === "fail") return "failed";
+  if (normalized === "passed" || normalized === "pass") return "passed";
+  if (normalized === "pending" || normalized === "todo" || normalized === "skipped" || normalized === "skip" || normalized === "disabled") {
+    return "skipped";
+  }
+  return void 0;
+}
+async function writeSafeArtifact(input) {
+  const artifactSeed = input.association.artifactLabel ?? input.testCase.id ?? input.testCase.fullName ?? input.status;
+  const artifactName = input.reserveArtifactName(artifactSeed);
+  const testFile = input.testCase.file === void 0 ? void 0 : path.basename(input.testCase.file);
+  const safeTestId = `${testFile ?? "unknown-file"}::${input.testCase.fullName}`;
+  const manifestPathResult = createReporterArtifactPath({
+    outputDir: input.artifactDir,
+    testId: artifactName,
+    name: input.testCase.fullName,
+    file: testFile,
+    kind: "report",
+    format: "json"
+  });
+  const summaryPathResult = createReporterArtifactPath({
+    outputDir: input.artifactDir,
+    testId: artifactName,
+    name: input.testCase.fullName,
+    file: testFile,
+    kind: "summary",
+    format: "md"
+  });
+  if (!manifestPathResult.ok || manifestPathResult.absolutePath === void 0 || manifestPathResult.relativePath === void 0) {
+    throw new Error(formatPathDiagnostics(manifestPathResult.diagnostics));
+  }
+  if (!summaryPathResult.ok || summaryPathResult.absolutePath === void 0 || summaryPathResult.relativePath === void 0) {
+    throw new Error(formatPathDiagnostics(summaryPathResult.diagnostics));
+  }
+  const directory = path.dirname(manifestPathResult.absolutePath);
+  await mkdir(directory, { recursive: true });
+  const traceFile = input.association.tracePath === void 0 ? void 0 : path.basename(input.association.tracePath);
+  const manifestArtifact = {
+    kind: "report",
+    path: manifestPathResult.relativePath,
+    format: "json",
+    redactionProfile: input.redactionProfile
+  };
+  const summaryArtifact = {
+    kind: "summary",
+    path: summaryPathResult.relativePath,
+    format: "md",
+    redactionProfile: input.redactionProfile
+  };
+  const manifest = createTraceArtifactManifest({
+    framework: "jest",
+    generatedAt: input.generatedAt,
+    results: [
+      {
+        testId: safeTestId,
+        name: input.testCase.fullName,
+        ...testFile === void 0 ? {} : { file: testFile },
+        status: input.status,
+        tracePath: safeOptional(traceFile),
+        artifacts: [manifestArtifact, summaryArtifact],
+        diagnostics: []
+      }
+    ],
+    artifacts: [manifestArtifact, summaryArtifact],
+    diagnostics: []
+  });
+  const trace = {
+    runId: safeOptional(input.association.runId),
+    file: safeOptional(traceFile)
+  };
+  await writeFile(
+    manifestPathResult.absolutePath,
+    `${JSON.stringify({ package: PACKAGE_NAME, manifest, trace }, null, 2)}
+`
+  );
+  const summaryPath = summaryPathResult.absolutePath;
+  await writeFile(summaryPath, renderSummary(manifest, trace), "utf-8");
+  return {
+    directory,
+    manifest,
+    manifestPath: manifestPathResult.absolutePath,
+    status: input.status,
+    summaryPath,
+    testId: safeTestId
+  };
+}
+function renderSummary(manifest, trace) {
+  const result = manifest.results[0];
+  return [
+    "# AgentInspect Jest Artifact",
+    "",
+    `- Test: ${result?.name ?? "unknown"}`,
+    `- Test id: ${result?.testId ?? "unknown"}`,
+    `- Status: ${result?.status ?? "unknown"}`,
+    `- File: ${result?.file ?? "unknown"}`,
+    `- Trace run: ${trace.runId ?? "unknown"}`,
+    `- Trace file: ${result?.tracePath ?? "unknown"}`,
+    `- Manifest schema: ${manifest.schemaVersion}`,
+    "",
+    "Trace contents are intentionally not embedded in this artifact.",
+    ""
+  ].join("\n");
+}
+function formatPathDiagnostics(diagnostics) {
+  if (diagnostics.length === 0) return "Unsafe AgentInspect Jest artifact path.";
+  return diagnostics.map((diagnostic) => diagnostic.message).join("; ");
+}
+function safeOptional(value) {
+  return value === void 0 ? void 0 : boundText(redactText(value));
+}
+function safeSegment(value) {
+  const sanitized = redactText(value).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+  return sanitized.length > 0 ? sanitized : "trace";
+}
+function boundText(value) {
+  const compact = value.replace(/\s+/g, " ").trim();
+  if (compact.length <= MAX_TEXT) return compact;
+  return `${compact.slice(0, MAX_TEXT - 12)}...[truncated]`;
+}
+function redactText(value) {
+  return value.replace(/\bsk-[A-Za-z0-9_-]{8,}\b/g, "[REDACTED]").replace(/\b(?:api[_-]?key|authorization|token|secret|password)\s*[:=]\s*[^,\s]+/gi, "$1=[REDACTED]");
+}
+function readOptionalString(value, key) {
+  if (!isObject(value)) return void 0;
+  const property = readProp(value, key);
+  return typeof property === "string" && property.length > 0 ? property : void 0;
+}
+function readProp(value, key) {
+  return value[key];
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export { AgentInspectJestReporter, agentInspectJestReporter, createAgentInspectJestReporter, index_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  createReporterArtifactPath,\n  createTraceArtifactManifest,\n  type TraceArtifact,\n  type TraceArtifactManifest,\n  type TraceArtifactRedactionProfile,\n  type TraceReporterDiagnostic,\n} from \"agent-inspect/reporters\";\n\nexport type AgentInspectJestStatus = \"failed\" | \"passed\" | \"skipped\";\n\n/**\n * Experimental trace association read by `@agent-inspect/jest`.\n *\n * Jest does not expose Vitest-style task metadata, so the default path is an\n * explicit `associations` map keyed by test identity, or a `resolveTrace`\n * callback. The reporter never guesses by timestamps.\n */\nexport interface AgentInspectJestTraceAssociation {\n  /** AgentInspect run/span identifier to show in safe artifacts. */\n  readonly runId?: string;\n  /** Local trace file path. Only the basename is written to artifacts. */\n  readonly tracePath?: string;\n  /** Optional stable label for the artifact directory. */\n  readonly artifactLabel?: string;\n}\n\n/**\n * Experimental normalized view of one Jest assertion result.\n */\nexport interface AgentInspectJestTestCase {\n  readonly id: string;\n  readonly title: string;\n  readonly fullName: string;\n  readonly file?: string;\n  readonly status: AgentInspectJestStatus;\n  readonly raw: unknown;\n}\n\n/**\n * Experimental diagnostic emitted when reporter work cannot be completed.\n *\n * Diagnostics are reported instead of thrown so Jest's original test result\n * remains authoritative.\n */\nexport interface AgentInspectJestDiagnostic {\n  readonly code:\n    | \"artifact-write-failed\"\n    | \"github-summary-write-failed\"\n    | \"on-diagnostic-failed\";\n  readonly message: string;\n  readonly testId?: string;\n}\n\n/**\n * Experimental options for the AgentInspect Jest reporter.\n *\n * The reporter is local-only: it performs no network I/O and writes bounded,\n * structural artifacts without reading trace contents.\n */\nexport interface AgentInspectJestReporterOptions {\n  /** Directory for safe Jest artifacts. Defaults to `.agent-inspect/jest-artifacts`. */\n  readonly artifactDir?: string;\n  /** Optional GitHub step-summary path. Only bounded structural lines are appended. */\n  readonly githubSummary?: string;\n  /**\n   * Keep artifacts for passing tests. `false`/undefined keeps none; `true`\n   * keeps up to `maxSuccessfulTraces`; a number keeps up to that many.\n   */\n  readonly retainSuccessful?: boolean | number;\n  /** Upper bound for retained passing-test artifacts. Defaults to 20. */\n  readonly maxSuccessfulTraces?: number;\n  /** Redaction profile recorded on generated artifacts. Defaults to `share`. */\n  readonly redactionProfile?: TraceArtifactRedactionProfile;\n  /** Deterministic manifest timestamp. Defaults to the Unix epoch. */\n  readonly generatedAt?: string;\n  /** Explicit trace associations keyed by `file::fullName`, `basename::fullName`, or `fullName`. */\n  readonly associations?: Record<string, AgentInspectJestTraceAssociation>;\n  /** Resolve explicit test-to-trace associations from a normalized Jest case. */\n  readonly resolveTrace?: (\n    test: AgentInspectJestTestCase,\n  ) => AgentInspectJestTraceAssociation | undefined;\n  /** Observe non-fatal reporter diagnostics. */\n  readonly onDiagnostic?: (diagnostic: AgentInspectJestDiagnostic) => void;\n}\n\nexport interface AgentInspectJestArtifact {\n  readonly directory: string;\n  readonly manifestPath: string;\n  readonly summaryPath: string;\n  readonly status: AgentInspectJestStatus;\n  readonly testId: string;\n  readonly manifest: TraceArtifactManifest;\n}\n\n/**\n * Experimental Jest reporter facade.\n *\n * The hooks mirror Jest reporter lifecycle names, while inputs stay structural\n * to avoid a runtime dependency on Jest internals.\n */\nexport interface AgentInspectJestReporterFacade {\n  onTestResult(test: unknown, testResult: unknown, aggregatedResult?: unknown): Promise<void>;\n  onRunComplete(contexts?: unknown, results?: unknown): Promise<void>;\n  getDiagnostics(): readonly AgentInspectJestDiagnostic[];\n  getArtifacts(): readonly AgentInspectJestArtifact[];\n}\n\ntype AssertionResultLike = {\n  readonly ancestorTitles?: unknown;\n  readonly title?: unknown;\n  readonly fullName?: unknown;\n  readonly status?: unknown;\n  readonly meta?: unknown;\n  readonly agentInspect?: unknown;\n};\n\ntype TestFileResultLike = {\n  readonly testFilePath?: unknown;\n  readonly testResults?: unknown;\n  readonly assertionResults?: unknown;\n};\n\nconst PACKAGE_NAME = \"@agent-inspect/jest\";\nconst DEFAULT_ARTIFACT_DIR = \".agent-inspect/jest-artifacts\";\nconst DEFAULT_SUCCESS_LIMIT = 20;\nconst MAX_SUCCESS_LIMIT = 100;\nconst MAX_TEXT = 180;\nconst DEFAULT_GENERATED_AT = \"1970-01-01T00:00:00.000Z\";\n\n/**\n * Create the experimental AgentInspect Jest reporter.\n */\nexport function createAgentInspectJestReporter(\n  options: AgentInspectJestReporterOptions = {},\n): AgentInspectJestReporterFacade {\n  const diagnostics: AgentInspectJestDiagnostic[] = [];\n  const artifacts: AgentInspectJestArtifact[] = [];\n  const seenKeys = new Set<string>();\n  const artifactNames = new Map<string, number>();\n  const successLimit = normalizeSuccessLimit(options);\n  let retainedSuccesses = 0;\n\n  const reporter: AgentInspectJestReporterFacade = {\n    async onTestResult(_test: unknown, testResult: unknown): Promise<void> {\n      await handleFileResult(testResult);\n    },\n    async onRunComplete(_contexts?: unknown, results?: unknown): Promise<void> {\n      for (const fileResult of readRunResults(results)) {\n        await handleFileResult(fileResult);\n      }\n      await appendGithubSummary();\n    },\n    getDiagnostics(): readonly AgentInspectJestDiagnostic[] {\n      return diagnostics.slice();\n    },\n    getArtifacts(): readonly AgentInspectJestArtifact[] {\n      return artifacts.slice();\n    },\n  };\n\n  async function handleFileResult(testResult: unknown): Promise<void> {\n    for (const testCase of readTestCases(testResult)) {\n      await handleTestCase(testCase);\n    }\n  }\n\n  async function handleTestCase(testCase: AgentInspectJestTestCase): Promise<void> {\n    const seenKey = `${testCase.id}:${testCase.status}`;\n    if (seenKeys.has(seenKey)) return;\n\n    const association = resolveAssociation(testCase, options);\n    if (association === undefined) return;\n\n    if (testCase.status === \"passed\") {\n      if (retainedSuccesses >= successLimit) return;\n      retainedSuccesses += 1;\n    }\n\n    seenKeys.add(seenKey);\n\n    try {\n      const artifact = await writeSafeArtifact({\n        artifactDir: options.artifactDir ?? DEFAULT_ARTIFACT_DIR,\n        association,\n        generatedAt: options.generatedAt ?? DEFAULT_GENERATED_AT,\n        redactionProfile: options.redactionProfile ?? \"share\",\n        reserveArtifactName,\n        status: testCase.status,\n        testCase,\n      });\n      artifacts.push(artifact);\n    } catch (error) {\n      reportDiagnostic({\n        code: \"artifact-write-failed\",\n        message: `Could not write AgentInspect Jest artifact: ${errorMessage(error)}`,\n        testId: testCase.id,\n      });\n    }\n  }\n\n  function reserveArtifactName(seed: string): string {\n    const base = safeSegment(seed);\n    const next = (artifactNames.get(base) ?? 0) + 1;\n    artifactNames.set(base, next);\n    return next === 1 ? base : `${base}-${next}`;\n  }\n\n  function reportDiagnostic(diagnostic: AgentInspectJestDiagnostic): void {\n    diagnostics.push(diagnostic);\n    if (options.onDiagnostic === undefined) return;\n    try {\n      options.onDiagnostic(diagnostic);\n    } catch (error) {\n      diagnostics.push({\n        code: \"on-diagnostic-failed\",\n        message: `AgentInspect Jest diagnostic callback failed: ${errorMessage(error)}`,\n        testId: diagnostic.testId,\n      });\n    }\n  }\n\n  async function appendGithubSummary(): Promise<void> {\n    if (options.githubSummary === undefined || artifacts.length === 0) return;\n    const failed = artifacts.filter((artifact) => artifact.status === \"failed\").length;\n    const passed = artifacts.filter((artifact) => artifact.status === \"passed\").length;\n    const lines = [\n      \"\",\n      \"## AgentInspect Jest artifacts\",\n      \"\",\n      `- Failed test artifacts: ${failed}`,\n      `- Passing test artifacts retained: ${passed}`,\n      `- Artifact directory: ${boundText(path.basename(options.artifactDir ?? DEFAULT_ARTIFACT_DIR))}`,\n      \"\",\n    ];\n    try {\n      await writeFile(options.githubSummary, `${lines.join(\"\\n\")}\\n`, { flag: \"a\" });\n    } catch (error) {\n      reportDiagnostic({\n        code: \"github-summary-write-failed\",\n        message: `Could not append AgentInspect Jest summary: ${errorMessage(error)}`,\n      });\n    }\n  }\n\n  return reporter;\n}\n\n/**\n * Experimental Jest custom reporter class.\n */\nexport class AgentInspectJestReporter implements AgentInspectJestReporterFacade {\n  private readonly reporter: AgentInspectJestReporterFacade;\n\n  constructor(_globalConfig?: unknown, options: AgentInspectJestReporterOptions = {}) {\n    this.reporter = createAgentInspectJestReporter(options);\n  }\n\n  async onTestResult(\n    test: unknown,\n    testResult: unknown,\n    aggregatedResult?: unknown,\n  ): Promise<void> {\n    await this.reporter.onTestResult(test, testResult, aggregatedResult);\n  }\n\n  async onRunComplete(contexts?: unknown, results?: unknown): Promise<void> {\n    await this.reporter.onRunComplete(contexts, results);\n  }\n\n  getDiagnostics(): readonly AgentInspectJestDiagnostic[] {\n    return this.reporter.getDiagnostics();\n  }\n\n  getArtifacts(): readonly AgentInspectJestArtifact[] {\n    return this.reporter.getArtifacts();\n  }\n}\n\nexport const agentInspectJestReporter = createAgentInspectJestReporter;\nexport default AgentInspectJestReporter;\n\nfunction normalizeSuccessLimit(options: AgentInspectJestReporterOptions): number {\n  const cap = clampCount(options.maxSuccessfulTraces, DEFAULT_SUCCESS_LIMIT);\n  if (options.retainSuccessful === true) return cap;\n  if (typeof options.retainSuccessful === \"number\") {\n    return Math.min(clampCount(options.retainSuccessful, 0), cap);\n  }\n  return 0;\n}\n\nfunction clampCount(value: number | undefined, fallback: number): number {\n  if (value === undefined || !Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(MAX_SUCCESS_LIMIT, Math.floor(value)));\n}\n\nfunction resolveAssociation(\n  testCase: AgentInspectJestTestCase,\n  options: AgentInspectJestReporterOptions,\n): AgentInspectJestTraceAssociation | undefined {\n  const resolved = options.resolveTrace?.(testCase);\n  if (isAssociation(resolved)) return resolved;\n\n  const explicit = resolveFromAssociationMap(testCase, options.associations);\n  if (explicit !== undefined) return explicit;\n\n  return readAssociationFromAssertion(testCase.raw);\n}\n\nfunction resolveFromAssociationMap(\n  testCase: AgentInspectJestTestCase,\n  associations: Record<string, AgentInspectJestTraceAssociation> | undefined,\n): AgentInspectJestTraceAssociation | undefined {\n  if (associations === undefined) return undefined;\n  const basename = testCase.file === undefined ? undefined : path.basename(testCase.file);\n  const candidates = [\n    testCase.id,\n    testCase.fullName,\n    basename === undefined ? undefined : `${basename}::${testCase.fullName}`,\n  ];\n  for (const candidate of candidates) {\n    if (candidate !== undefined && isAssociation(associations[candidate])) {\n      return associations[candidate];\n    }\n  }\n  return undefined;\n}\n\nfunction readAssociationFromAssertion(\n  assertion: unknown,\n): AgentInspectJestTraceAssociation | undefined {\n  if (!isObject(assertion)) return undefined;\n  const direct = readProp(assertion, \"agentInspect\");\n  if (isAssociation(direct)) return direct;\n\n  const meta = readProp(assertion, \"meta\");\n  if (!isObject(meta)) return undefined;\n  for (const candidate of [\n    readProp(meta, \"agentInspect\"),\n    readProp(meta, \"agent-inspect\"),\n    readProp(meta, \"trace\"),\n  ]) {\n    if (isAssociation(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction isAssociation(\n  value: unknown,\n): value is AgentInspectJestTraceAssociation {\n  if (!isObject(value)) return false;\n  return (\n    readOptionalString(value, \"runId\") !== undefined ||\n    readOptionalString(value, \"tracePath\") !== undefined ||\n    readOptionalString(value, \"artifactLabel\") !== undefined\n  );\n}\n\nfunction readRunResults(results: unknown): unknown[] {\n  if (!isObject(results)) return [];\n  const testResults = readProp(results, \"testResults\");\n  return Array.isArray(testResults) ? testResults : [];\n}\n\nfunction readTestCases(testResult: unknown): AgentInspectJestTestCase[] {\n  if (!isObject(testResult)) return [];\n  const result = testResult as TestFileResultLike;\n  const file = readOptionalString(result, \"testFilePath\");\n  const assertions = Array.isArray(result.testResults)\n    ? result.testResults\n    : Array.isArray(result.assertionResults)\n      ? result.assertionResults\n      : [];\n\n  const cases: AgentInspectJestTestCase[] = [];\n  for (const assertion of assertions) {\n    if (!isObject(assertion)) continue;\n    const status = readStatus(assertion);\n    if (status === undefined || status === \"skipped\") continue;\n\n    const title = readOptionalString(assertion, \"title\") ?? \"unknown-test\";\n    const fullName = readFullName(assertion as AssertionResultLike, title);\n    const id = `${file ?? \"unknown-file\"}::${fullName}`;\n    cases.push({\n      file,\n      fullName: boundText(redactText(fullName)),\n      id: boundText(redactText(id)),\n      raw: assertion,\n      status,\n      title: boundText(redactText(title)),\n    });\n  }\n  return cases;\n}\n\nfunction readFullName(assertion: AssertionResultLike, title: string): string {\n  const explicit = readOptionalString(assertion, \"fullName\");\n  if (explicit !== undefined) return explicit;\n\n  const ancestors = Array.isArray(assertion.ancestorTitles)\n    ? assertion.ancestorTitles.filter((item): item is string => typeof item === \"string\")\n    : [];\n  return [...ancestors, title].join(\" \");\n}\n\nfunction readStatus(assertion: object): AgentInspectJestStatus | undefined {\n  const raw = readOptionalString(assertion, \"status\");\n  if (raw === undefined) return undefined;\n\n  const normalized = raw.toLowerCase();\n  if (normalized === \"failed\" || normalized === \"fail\") return \"failed\";\n  if (normalized === \"passed\" || normalized === \"pass\") return \"passed\";\n  if (\n    normalized === \"pending\" ||\n    normalized === \"todo\" ||\n    normalized === \"skipped\" ||\n    normalized === \"skip\" ||\n    normalized === \"disabled\"\n  ) {\n    return \"skipped\";\n  }\n  return undefined;\n}\n\nasync function writeSafeArtifact(input: {\n  readonly artifactDir: string;\n  readonly association: AgentInspectJestTraceAssociation;\n  readonly generatedAt: string;\n  readonly redactionProfile: TraceArtifactRedactionProfile;\n  readonly reserveArtifactName: (seed: string) => string;\n  readonly status: AgentInspectJestStatus;\n  readonly testCase: AgentInspectJestTestCase;\n}): Promise<AgentInspectJestArtifact> {\n  const artifactSeed =\n    input.association.artifactLabel ??\n    input.testCase.id ??\n    input.testCase.fullName ??\n    input.status;\n  const artifactName = input.reserveArtifactName(artifactSeed);\n  const testFile =\n    input.testCase.file === undefined ? undefined : path.basename(input.testCase.file);\n  const safeTestId = `${testFile ?? \"unknown-file\"}::${input.testCase.fullName}`;\n  const manifestPathResult = createReporterArtifactPath({\n    outputDir: input.artifactDir,\n    testId: artifactName,\n    name: input.testCase.fullName,\n    file: testFile,\n    kind: \"report\",\n    format: \"json\",\n  });\n  const summaryPathResult = createReporterArtifactPath({\n    outputDir: input.artifactDir,\n    testId: artifactName,\n    name: input.testCase.fullName,\n    file: testFile,\n    kind: \"summary\",\n    format: \"md\",\n  });\n\n  if (\n    !manifestPathResult.ok ||\n    manifestPathResult.absolutePath === undefined ||\n    manifestPathResult.relativePath === undefined\n  ) {\n    throw new Error(formatPathDiagnostics(manifestPathResult.diagnostics));\n  }\n  if (\n    !summaryPathResult.ok ||\n    summaryPathResult.absolutePath === undefined ||\n    summaryPathResult.relativePath === undefined\n  ) {\n    throw new Error(formatPathDiagnostics(summaryPathResult.diagnostics));\n  }\n\n  const directory = path.dirname(manifestPathResult.absolutePath);\n  await mkdir(directory, { recursive: true });\n\n  const traceFile =\n    input.association.tracePath === undefined\n      ? undefined\n      : path.basename(input.association.tracePath);\n  const manifestArtifact: TraceArtifact = {\n    kind: \"report\",\n    path: manifestPathResult.relativePath,\n    format: \"json\",\n    redactionProfile: input.redactionProfile,\n  };\n  const summaryArtifact: TraceArtifact = {\n    kind: \"summary\",\n    path: summaryPathResult.relativePath,\n    format: \"md\",\n    redactionProfile: input.redactionProfile,\n  };\n  const manifest = createTraceArtifactManifest({\n    framework: \"jest\",\n    generatedAt: input.generatedAt,\n    results: [\n      {\n        testId: safeTestId,\n        name: input.testCase.fullName,\n        ...(testFile === undefined ? {} : { file: testFile }),\n        status: input.status,\n        tracePath: safeOptional(traceFile),\n        artifacts: [manifestArtifact, summaryArtifact],\n        diagnostics: [],\n      },\n    ],\n    artifacts: [manifestArtifact, summaryArtifact],\n    diagnostics: [],\n  });\n  const trace = {\n    runId: safeOptional(input.association.runId),\n    file: safeOptional(traceFile),\n  };\n\n  await writeFile(\n    manifestPathResult.absolutePath,\n    `${JSON.stringify({ package: PACKAGE_NAME, manifest, trace }, null, 2)}\\n`,\n  );\n  const summaryPath = summaryPathResult.absolutePath;\n  await writeFile(summaryPath, renderSummary(manifest, trace), \"utf-8\");\n\n  return {\n    directory,\n    manifest,\n    manifestPath: manifestPathResult.absolutePath,\n    status: input.status,\n    summaryPath,\n    testId: safeTestId,\n  };\n}\n\nfunction renderSummary(\n  manifest: TraceArtifactManifest,\n  trace: { readonly runId?: string; readonly file?: string },\n): string {\n  const result = manifest.results[0];\n  return [\n    \"# AgentInspect Jest Artifact\",\n    \"\",\n    `- Test: ${result?.name ?? \"unknown\"}`,\n    `- Test id: ${result?.testId ?? \"unknown\"}`,\n    `- Status: ${result?.status ?? \"unknown\"}`,\n    `- File: ${result?.file ?? \"unknown\"}`,\n    `- Trace run: ${trace.runId ?? \"unknown\"}`,\n    `- Trace file: ${result?.tracePath ?? \"unknown\"}`,\n    `- Manifest schema: ${manifest.schemaVersion}`,\n    \"\",\n    \"Trace contents are intentionally not embedded in this artifact.\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nfunction formatPathDiagnostics(\n  diagnostics: readonly TraceReporterDiagnostic[],\n): string {\n  if (diagnostics.length === 0) return \"Unsafe AgentInspect Jest artifact path.\";\n  return diagnostics.map((diagnostic) => diagnostic.message).join(\"; \");\n}\n\nfunction safeOptional(value: string | undefined): string | undefined {\n  return value === undefined ? undefined : boundText(redactText(value));\n}\n\nfunction safeSegment(value: string): string {\n  const sanitized = redactText(value)\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 80);\n  return sanitized.length > 0 ? sanitized : \"trace\";\n}\n\nfunction boundText(value: string): string {\n  const compact = value.replace(/\\s+/g, \" \").trim();\n  if (compact.length <= MAX_TEXT) return compact;\n  return `${compact.slice(0, MAX_TEXT - 12)}...[truncated]`;\n}\n\nfunction redactText(value: string): string {\n  return value\n    .replace(/\\bsk-[A-Za-z0-9_-]{8,}\\b/g, \"[REDACTED]\")\n    .replace(/\\b(?:api[_-]?key|authorization|token|secret|password)\\s*[:=]\\s*[^,\\s]+/gi, \"$1=[REDACTED]\");\n}\n\nfunction readOptionalString(value: unknown, key: string): string | undefined {\n  if (!isObject(value)) return undefined;\n  const property = readProp(value, key);\n  return typeof property === \"string\" && property.length > 0 ? property : undefined;\n}\n\nfunction readProp(value: object, key: string): unknown {\n  return (value as Record<string, unknown>)[key];\n}\n\nfunction isObject(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@agent-inspect/jest",
+  "version": "2.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Optional Jest reporter for AgentInspect local trace artifacts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rajudandigam/agent-inspect.git",
+    "directory": "packages/jest"
+  },
+  "bugs": {
+    "url": "https://github.com/rajudandigam/agent-inspect/issues"
+  },
+  "homepage": "https://github.com/rajudandigam/agent-inspect#readme",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "jest": "^29.0.0 || ^30.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "agent-inspect": "2.1.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm --workspace-root exec tsup --config tsup.jest.config.ts",
+    "test": "vitest run -c ../../vitest.config.ts"
+  }
+}