agent-inspect 3.5.1 → 3.5.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 3.5.3
+
+### Patch Changes
+
+- 05546b5: v3.5.3 docs hygiene: lean docs index, archive stale files, remove unavailable hero SVG from npm package files. Docs-only.
+
+## 3.5.2
+
+### Patch Changes
+
+- 14d4ccc: v3.5.2 adoption demo kit: DEMO-SCRIPT, PITCH, Show HN draft, video script, SCREENSHOTS diagram index. Docs-only.
+
 ## 3.5.1
 
 ### Patch Changes

package/README.md

@@ -7,8 +7,6 @@ No account · no upload · no hosted dashboard · metadata-only by default
 [![npm version](https://img.shields.io/npm/v/agent-inspect.svg)](https://www.npmjs.com/package/agent-inspect)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-![AgentInspect loop: trace → check → redact](docs/assets/agent-inspect-loop.svg)
-
 ```bash
 npm install agent-inspect
 ```
@@ -56,7 +54,7 @@ Blessed starters (no API keys): [examples/starters](https://github.com/rajudandi
 | Scenario | Doc |
 | -------- | --- |
 | Local debugging | [USE-CASES.md](docs/USE-CASES.md) |
-| CI failure review | [REAL-WORLD-SCENARIOS.md](docs/REAL-WORLD-SCENARIOS.md) |
+| CI failure review | [USE-CASES.md](docs/USE-CASES.md) § CI trace artifact |
 | Team adoption | [TEAM-WORKFLOWS.md](docs/TEAM-WORKFLOWS.md) · [Design partners](docs/DESIGN-PARTNER-GUIDE.md) |
 
 ## Package map
@@ -97,8 +95,8 @@ Details: [Safe trace sharing](docs/SAFE-TRACE-SHARING.md) · [Security](SECURITY
 | Start | Reference | Adoption |
 | ----- | --------- | -------- |
 | [Getting started](docs/GETTING-STARTED.md) | [API](docs/API.md) | [Adoption](docs/ADOPTION.md) |
-| [One-page quickstart](docs/ONE-PAGE-QUICKSTART.md) | [CLI](docs/CLI.md) | [Demo script](docs/DEMO-SCRIPT.md) |
-| [First trace in 5 min](docs/FIRST-TRACE-IN-5-MINUTES.md) | [Adapters](docs/ADAPTERS.md) | [Compare](docs/COMPARE.md) |
+| [First trace in 5 min](docs/FIRST-TRACE-IN-5-MINUTES.md) | [CLI](docs/CLI.md) | [Demo script](docs/DEMO-SCRIPT.md) |
+| [Use cases](docs/USE-CASES.md) | [Adapters](docs/ADAPTERS.md) | [Compare](docs/COMPARE.md) |
 | [Examples](https://github.com/rajudandigam/agent-inspect/tree/main/examples) | [Performance](docs/PERFORMANCE.md) | [Pitch](docs/PITCH.md) |
 
 Full index: [docs/README.md](docs/README.md) · Visual demos: [SCREENSHOTS.md](docs/SCREENSHOTS.md)
@@ -113,7 +111,7 @@ Full index: [docs/README.md](docs/README.md) · Visual demos: [SCREENSHOTS.md](d
 
 ## Install details
 
-Current release: **3.5.0** (sixteen linked npm packages). Persisted trace schema **1.0**.
+Current release: **3.5.2** (sixteen linked npm packages). Persisted trace schema **1.0**.
 
 ```bash
 pnpm add agent-inspect

package/SECURITY.md

@@ -93,5 +93,5 @@ For a practical pre-share workflow, see `docs/SAFE-TRACE-SHARING.md`. For schema
 - Does not invoke user agent tools or mutate traces.
 - Configure via `AGENT_INSPECT_TRACE_DIR` and `AGENT_INSPECT_MCP_REDACTION_PROFILE` when documented.
 
-IDE marketplace extension is **deferred** — see [docs/IDE-SURFACES.md](docs/IDE-SURFACES.md).
+IDE extension: see [VSCODE.md](docs/VSCODE.md) (in-repo; Marketplace deferred).
 

package/docs/ADAPTERS.md

@@ -494,7 +494,7 @@ import { runReadOnlyMcpServer } from "@agent-inspect/mcp-server";
 await runReadOnlyMcpServer({ redactionProfile: "share" });
 ```
 
-Recipe: [examples/recipes/read-only-mcp-server](../examples/recipes/read-only-mcp-server/). IDE extension deferred: [IDE-SURFACES.md](./IDE-SURFACES.md).
+Recipe: [examples/recipes/read-only-mcp-server](../examples/recipes/read-only-mcp-server/). VS Code: [VSCODE.md](./VSCODE.md).
 
 ---
 

package/docs/FIRST-TRACE-IN-5-MINUTES.md

@@ -2,6 +2,12 @@
 
 Goal: install → one trace → one check → one share-safe artifact.
 
+```bash
+npm install agent-inspect && npx agent-inspect init --yes && node examples/agent-inspect-demo.mjs
+npx agent-inspect list --dir .agent-inspect && npx agent-inspect report <run-id> --dir .agent-inspect
+npx agent-inspect check .agent-inspect/*.jsonl && npx agent-inspect verify-safe --dir .agent-inspect
+```
+
 ## Minutes 0–1: Install
 
 ```bash

package/docs/GETTING-STARTED.md

@@ -12,7 +12,7 @@ pnpm add agent-inspect
 
 ### Quick bootstrap (v3.1+)
 
-See also [FIRST-TRACE-IN-5-MINUTES.md](./FIRST-TRACE-IN-5-MINUTES.md) and [ONE-PAGE-QUICKSTART.md](./ONE-PAGE-QUICKSTART.md).
+See also [FIRST-TRACE-IN-5-MINUTES.md](./FIRST-TRACE-IN-5-MINUTES.md).
 
 ```bash
 npx agent-inspect init --yes

package/docs/MIGRATION.md

@@ -73,7 +73,7 @@ v3.0 is a **linked npm major** for the public package family. **Persisted trace
 ### What changes
 
 - New optional package [`@agent-inspect/adapter-sdk`](https://www.npmjs.com/package/@agent-inspect/adapter-sdk) for third-party adapter authoring (registration, conformance, privacy checklist, transform/renderer/indexer contracts).
-- Community extension process documented in [COMMUNITY-EXTENSION-REGISTRY.md](./COMMUNITY-EXTENSION-REGISTRY.md).
+- Community extensions: [ADAPTER-CONFORMANCE.md](./ADAPTER-CONFORMANCE.md) and [`@agent-inspect/adapter-sdk`](../packages/adapter-sdk/README.md).
 - Extension interfaces are versioned in `@agent-inspect/adapter-sdk@3.x`; breaking extension API changes ship there, not in silent root patches.
 
 ### What stays the same

package/docs/SCREENSHOTS.md

@@ -1,13 +1,31 @@
 # Visual demos
 
-Curated terminal recordings for AgentInspect **1.4.0**. They show what the local trace workbench captures and how to inspect it — without a hosted dashboard or vendor upload.
+Curated terminal recordings and static diagrams for AgentInspect **3.5.x**. They show what the local trace workbench captures and how to inspect it — without a hosted dashboard or vendor upload.
 
 **Synthetic output only:** demos use committed [fixtures](../fixtures/README.md), [examples](../examples/README.md), and recipes. No external LLM calls or API keys.
 
 **npm note:** GIFs live in `docs/assets/demos/` for GitHub documentation. They are **not** shipped in the `agent-inspect` npm tarball.
 
-**Re-record guide:** [assets/demos/RECORDING.md](assets/demos/RECORDING.md)  
+**Re-record guide:** [assets/demos/RECORDING.md](assets/demos/RECORDING.md)
 **Maintainer audit:** [implementation/VISUAL-DEMO-AUDIT.md](implementation/VISUAL-DEMO-AUDIT.md)
+**Live demo script:** [DEMO-SCRIPT.md](DEMO-SCRIPT.md) (uses [broken-agent-debugging](../examples/starters/broken-agent-debugging/) starter)
+
+---
+
+## Adoption demo (v3.5.2)
+
+Deterministic broken-agent flow — recommended for live demos and Show HN rehearsal.
+
+**Run:**
+
+```bash
+cd examples/starters/broken-agent-debugging
+pnpm install && pnpm start
+npx agent-inspect report <run-id> --dir .agent-inspect
+npx agent-inspect redact .agent-inspect/*.jsonl --profile share -o safe.jsonl
+```
+
+**GIF status:** re-record optional; use [error-handling.gif](assets/demos/error-handling.gif) as b-roll until a dedicated broken-agent GIF exists.
 
 ---
 

package/docs/USE-CASES.md

@@ -19,7 +19,7 @@ npx agent-inspect report <run-id> --dir .agent-inspect
 
 **Safety:** Metadata-only default. Redact before sharing: `npx agent-inspect redact --profile share`.
 
-**Starter:** [custom-observe](../examples/starters/custom-observe/README.md)
+**Starter:** [broken-agent-debugging](../examples/starters/broken-agent-debugging/README.md) (intentional failure) or [custom-observe](../examples/starters/custom-observe/README.md)
 
 **Not:** Live model replay or hosted trace UI.
 
@@ -113,4 +113,4 @@ npx agent-inspect check .agent-inspect/*.jsonl --require-completed
 
 ---
 
-See also: [Real-world scenarios](./REAL-WORLD-SCENARIOS.md) · [Team workflows](./TEAM-WORKFLOWS.md)
+See also: [Team workflows](./TEAM-WORKFLOWS.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-inspect",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "license": "MIT",
   "type": "module",
   "description": "Local-first execution-tree debugger for TypeScript AI agents",
@@ -148,11 +148,7 @@
     "docs/CI-ARTIFACTS.md",
     "docs/PERFORMANCE.md",
     "docs/FIRST-TRACE-IN-5-MINUTES.md",
-    "docs/ONE-PAGE-QUICKSTART.md",
-    "docs/USE-CASES.md",
-    "docs/assets/agent-inspect-loop.svg",
-    "docs/assets/trace-check-redact.svg",
-    "docs/assets/package-map.svg"
+    "docs/USE-CASES.md"
   ],
   "sideEffects": false,
   "keywords": [

package/packages/cli/dist/index.cjs

@@ -25,7 +25,7 @@ var process3__default = /*#__PURE__*/_interopDefault(process3);
 var tty__default = /*#__PURE__*/_interopDefault(tty);
 
 // package.json
-var version = "3.5.1";
+var version = "3.5.3";
 
 // packages/core/src/correlation-metadata.ts
 var TRACE_CORRELATION_KEYS = [