agent-inspect 6.31.1 → 6.31.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 6.31.2
+
+### Patch Changes
+
+- 520c7c3: Clarify README Prevent path (trajectory without leading observation flags), AI SDK inspect/bundle commands, and Jest/Vitest explicit trace association in CI docs.
+
 ## 6.31.1
 
 ### Patch Changes

package/README.md

@@ -74,10 +74,11 @@ Checks are deterministic and provider-free: the same trace and rules produce the
 ```bash
 npx agent-inspect check <run-id> --dir .agent-inspect \
   --preset trajectory \
-  --required-tool retrieve_policy \
-  --fail-on-observation failed
+  --required-tool retrieve_policy
 ```
 
+Use `--fail-on-observation failed` only when the run records explicit OUTCOME events (for example the [broken-agent-debugging starter](https://github.com/rajudandigam/agent-inspect/tree/main/examples/starters/broken-agent-debugging)). Trajectory checks do not invent outcomes from tool/LLM/run success.
+
 A passing check exits `0`; a rule failure exits `1`. Invalid configuration and unreadable/unsupported inputs use separate documented exit codes. Use TraceContract, suites, cohorts, Vitest/Jest reporters, or `--evidence-on fail` when the workflow needs more than one CLI check.
 
 ### Share — create reviewable offline evidence
@@ -212,7 +213,7 @@ The root package is enough for custom capture, the CLI, checks, and Evidence wor
 
 ## Status and documentation
 
-**Current published baseline:** **6.31.1** · persisted schema `1.0` · Node.js `>=20` · MIT.
+**Current published baseline:** **6.31.2** · persisted schema `1.0` · Node.js `>=20` · MIT.
 
 Legacy v0.1 and v0.2 traces remain readable. Check the npm badge and [changelog](CHANGELOG.md) for the current published version.
 

package/docs/AI-SDK-ADOPTION.md

@@ -97,10 +97,15 @@ sensitive free text; redact before sharing. Full contract:
 
 ```bash
 npx agent-inspect list --dir .agent-inspect
-npx agent-inspect open .agent-inspect/<run>.jsonl
-npx agent-inspect check .agent-inspect/<run>.jsonl
+npx agent-inspect view <run-id> --dir .agent-inspect --summary
+npx agent-inspect check <run-id> --dir .agent-inspect --preset trajectory
+npx agent-inspect verify-safe <run-id> --dir .agent-inspect
+npx agent-inspect bundle <run-id> --dir .agent-inspect --profile share --out ./evidence
+npx agent-inspect bundle verify ./evidence
 ```
 
+Use `--fail-on-observation` only when the run records explicit OUTCOME events.
+
 ## Troubleshooting
 
 | Symptom | Fix |

package/docs/CI-ARTIFACTS.md

@@ -56,6 +56,8 @@ npx agent-inspect ci-summary .agent-inspect/jest-artifacts/tests/**/report.json
 
 `ci-summary` writes local files only. It validates reporter artifact paths as relative paths and includes bounded structural metadata: package/framework, test status counts, trace filenames, artifact paths, redaction profile, and diagnostic counts.
 
+**Jest / Vitest association:** reporters do **not** invent run↔test links from timestamps. Wire an explicit association (`withAgentInspectJestTrace`, reporter `associations` / `resolveTrace`, or the Vitest equivalents) or expect a `no-trace-association` diagnostic. See [`@agent-inspect/jest`](https://github.com/rajudandigam/agent-inspect/blob/main/packages/jest/README.md#trace-association) and [`@agent-inspect/vitest`](https://github.com/rajudandigam/agent-inspect/blob/main/packages/vitest/README.md).
+
 ```bash
 npx agent-inspect export <run-id> --dir ./.agent-inspect \
   --format markdown --redaction-profile share -o ./artifacts/trace.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-inspect",
-  "version": "6.31.1",
+  "version": "6.31.2",
   "license": "MIT",
   "type": "module",
   "description": "Local evidence debugger and trajectory-test toolkit for TypeScript AI agents — execution trees, TraceContract checks, Evidence v2, and read-only MCP",

package/packages/cli/dist/index.cjs

@@ -16153,7 +16153,7 @@ var init_src = __esm({
 });
 
 // package.json
-var version = "6.31.1";
+var version = "6.31.2";
 
 // packages/cli/src/list.ts
 init_advanced();