agent-inspect 3.5.2 → 3.5.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

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

@@ -4,7 +4,7 @@ Curated terminal recordings and static diagrams for AgentInspect **3.5.x**. They
 
 **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. Static SVG diagrams in `docs/assets/` are included in the root npm package.
+**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)
 **Maintainer audit:** [implementation/VISUAL-DEMO-AUDIT.md](implementation/VISUAL-DEMO-AUDIT.md)
@@ -12,20 +12,6 @@ Curated terminal recordings and static diagrams for AgentInspect **3.5.x**. They
 
 ---
 
-## Product diagrams (static)
-
-No terminal recording required — safe for README and docs.
-
-| Diagram | Purpose |
-| ------- | ------- |
-| [agent-inspect-loop.svg](assets/agent-inspect-loop.svg) | Trace → check → redact → share (local only) |
-| [trace-check-redact.svg](assets/trace-check-redact.svg) | Workflow from JSONL to share-safe artifact |
-| [package-map.svg](assets/package-map.svg) | Core + adapter + quality + safety packages |
-
-Embedded in root [README](../README.md). Workflow: [FIRST-TRACE-IN-5-MINUTES.md](FIRST-TRACE-IN-5-MINUTES.md).
-
----
-
 ## Adoption demo (v3.5.2)
 
 Deterministic broken-agent flow — recommended for live demos and Show HN rehearsal.

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.2",
+  "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.2";
+var version = "3.5.3";
 
 // packages/core/src/correlation-metadata.ts
 var TRACE_CORRELATION_KEYS = [