@tonyclaw/agent-inspector 2.0.18 → 2.0.19

package/.output/server/{_tanstack-start-manifest_v-Bvdz_U0f.mjs → _tanstack-start-manifest_v-yx8ftqWz.mjs}

@@ -1,4 +1,4 @@
-const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-BRXsrxtv.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-37NfO0zx.js", "/assets/ProxyViewerContainer-BG7rc33d.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-CsNARHj5.js", "/assets/ProxyViewerContainer-BG7rc33d.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-BRXsrxtv.js" });
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-o9-hg8g1.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-BbFsmQRC.js", "/assets/ProxyViewerContainer-CxRDWacg.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-CJ-SusES.js", "/assets/ProxyViewerContainer-CxRDWacg.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-o9-hg8g1.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -38,100 +38,100 @@ const assets = {
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-27T08:36:43.687Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/CompareDrawer-CepU-dLW.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"49fe-tnwk5QP+MvW6xIiE1eKLYM0+8Nk"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 18942,
-    "path": "../public/assets/CompareDrawer-CepU-dLW.js"
+  "/assets/index-BfBgrkgU.css": {
+    "type": "text/css; charset=utf-8",
+    "etag": '"1a2c9-oAW5yRzaizIi778RSlqZhPc85Pw"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 107209,
+    "path": "../public/assets/index-BfBgrkgU.css"
   },
-  "/assets/index-37NfO0zx.js": {
+  "/assets/index-BbFsmQRC.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"74-v4YTqp1BJEeiYpqdSM0kSIiMfRI"',
-    "mtime": "2026-06-27T08:36:43.690Z",
+    "etag": '"74-vI6w+1iyboIWfJVk8/ech/2b8UY"',
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 116,
-    "path": "../public/assets/index-37NfO0zx.js"
+    "path": "../public/assets/index-BbFsmQRC.js"
   },
-  "/assets/index-D_nZj9Vt.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"1a275-7T1iSNG2p6BSsqLwdpfky+9evLw"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 107125,
-    "path": "../public/assets/index-D_nZj9Vt.css"
+  "/assets/CompareDrawer-D-90PIPw.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"49fe-wIGG2knR51mFyL2vstdm6VenVaI"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 18942,
+    "path": "../public/assets/CompareDrawer-D-90PIPw.js"
   },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-27T08:36:43.689Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/ReplayDialog-DK6SPv8X.js": {
+  "/assets/ReplayDialog-DzlLYoTO.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"2361-0dSXxS+yW+fQ1Hwob3rFIHG/8kQ"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 9057,
-    "path": "../public/assets/ReplayDialog-DK6SPv8X.js"
+    "etag": '"318c-bOjCbSP/w/aeX1kn9QRZtFGLMFY"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 12684,
+    "path": "../public/assets/ReplayDialog-DzlLYoTO.js"
   },
-  "/assets/RequestAnatomy-C_C6ZU3T.js": {
+  "/assets/RequestAnatomy-0hbyf6oa.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-V13BHPKtOZXhurKshD6hPJdOMjM"',
-    "mtime": "2026-06-27T08:36:43.690Z",
+    "etag": '"4485-EusuohynIBF0h9+uJ+g1znFjMpc"',
+    "mtime": "2026-06-29T02:52:50.787Z",
     "size": 17541,
-    "path": "../public/assets/RequestAnatomy-C_C6ZU3T.js"
+    "path": "../public/assets/RequestAnatomy-0hbyf6oa.js"
   },
-  "/assets/ResponseView-Bqpra4Zw.js": {
+  "/assets/StreamingChunkSequence-enhfdeNh.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"30cd-PKvvu6r831JLikIZLvwX2YM2ppo"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 12493,
-    "path": "../public/assets/ResponseView-Bqpra4Zw.js"
+    "etag": '"d57-tC/D5hLCBdTaOabqUAFaXVthebA"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 3415,
+    "path": "../public/assets/StreamingChunkSequence-enhfdeNh.js"
   },
-  "/assets/main-BRXsrxtv.js": {
+  "/assets/ResponseView-CKe0tNqr.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"51726-Qo0oVA+vO57y3JomfqOlDMWH9Rw"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 333606,
-    "path": "../public/assets/main-BRXsrxtv.js"
+    "etag": '"30d0-N2ASszGo1KTiM+aCCKGHlqvDV+0"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 12496,
+    "path": "../public/assets/ResponseView-CKe0tNqr.js"
   },
-  "/assets/StreamingChunkSequence-CdPbpprq.js": {
+  "/assets/_sessionId-CJ-SusES.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d5b-YkikdGZkub445VaoQLxeiOhJX2I"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 3419,
-    "path": "../public/assets/StreamingChunkSequence-CdPbpprq.js"
+    "etag": '"d2-B/4bxwxZCrYG2uo6f9Vw/Iubu34"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 210,
+    "path": "../public/assets/_sessionId-CJ-SusES.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-27T08:36:43.689Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/_sessionId-CsNARHj5.js": {
+  "/assets/main-o9-hg8g1.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-/1womMucNX0MQlv0PbfYhhW01rc"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 210,
-    "path": "../public/assets/_sessionId-CsNARHj5.js"
+    "etag": '"51726-j0zx0pW0MFG6YpQKGgNUrH681sU"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 333606,
+    "path": "../public/assets/main-o9-hg8g1.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-27T08:36:43.689Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-BG7rc33d.js": {
+  "/assets/ProxyViewerContainer-CxRDWacg.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"aa779-KSDOFLdOzzw4sKAgeq6GqW/vv6k"',
-    "mtime": "2026-06-27T08:36:43.690Z",
-    "size": 698233,
-    "path": "../public/assets/ProxyViewerContainer-BG7rc33d.js"
+    "etag": '"ac0f7-VR6Thj9R1PGTEGYWEufABFZwNSM"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 704759,
+    "path": "../public/assets/ProxyViewerContainer-CxRDWacg.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -103,6 +103,15 @@ ANTHROPIC_BASE_URL=http://localhost:25947/proxy <tool>
 
 The web UI runs at http://localhost:25947.
 
+## Documentation Map
+
+- [Installation](docs/Installation.md): install and runtime notes.
+- [Usage](docs/Usage.md): daily capture, browsing, replay, and export workflows.
+- [MCP Server](docs/MCP-Server.md): MCP setup and tool usage for coding agents.
+- [Troubleshooting](docs/TROUBLESHOOTING.md): port, provider, MCP, Replay, Jenkins, and GitCode fixes.
+- [Jenkins + GitCode WebHook](docs/JENKINS_GITCODE_WEBHOOK_TUNNEL.md): team CI and tunnel setup.
+- [Local Release Helper](docs/LOCAL_RELEASE.md): local maintainer release helper.
+
 ## Capture Modes
 
 Agent Inspector starts in `simple` capture mode by default:
@@ -133,116 +142,9 @@ can also set `AGENT_INSPECTOR_MODE=full` or
 `AGENT_INSPECTOR_CAPTURE_MODE=full`; the CLI flag takes precedence over the
 environment.
 
-## Jenkins Release Webhook
-
-The `agent-inspector-release` Jenkins pipeline can be triggered from GitCode by
-using the Jenkins Git plugin `notifyCommit` endpoint. The Jenkins instance must
-be reachable from GitCode; `localhost`, LAN-only addresses, or NAT public IPs
-without port forwarding will not work. Use a public Jenkins URL, a reverse
-proxy, or a tunnel such as Cloudflare Tunnel, frp, or ngrok.
-
-Create a GitCode WebHook under the repository settings with these values:
-
-```text
-URL:
-https://<public-jenkins-host>/git/notifyCommit?url=https://gitcode.com/TonyClaw/agent-inspector&token=<jenkins-git-notify-token>
-
-WebHook password/signing secret:
-leave empty
-
-POST content type:
-application/json
-
-Events:
-Push events only
-
-Active:
-enabled
-```
-
-The Jenkins job must have SCM polling enabled so the Git plugin can schedule the
-pipeline after receiving the `notifyCommit` request. Do not commit the real
-Jenkins notify token to the repository.
-
-### Local Push Fallback
-
-When GitCode cannot reach a local Jenkins instance from the public internet, the
-tracked Husky `pre-push` hook can notify Jenkins from the developer machine that
-runs `git push`.
-
-Configure the local secret values once per clone:
-
-```bash
-git config --local agentInspector.jenkinsUrl http://localhost:8080
-git config --local agentInspector.repositoryUrl https://gitcode.com/TonyClaw/agent-inspector
-git config --local agentInspector.jenkinsNotifyToken <jenkins-git-notify-token>
-```
-
-On Windows PowerShell:
-
-```powershell
-git config --local agentInspector.jenkinsUrl http://localhost:8080
-git config --local agentInspector.repositoryUrl https://gitcode.com/TonyClaw/agent-inspector
-git config --local agentInspector.jenkinsNotifyToken <jenkins-git-notify-token>
-```
-
-After a `main` branch push, the hook waits briefly and then calls Jenkins
-`/git/notifyCommit` from the local machine. The hook can also be configured with
-environment variables instead of local Git config:
-
-```bash
-AGENT_INSPECTOR_JENKINS_URL=http://localhost:8080
-AGENT_INSPECTOR_REPOSITORY_URL=https://gitcode.com/TonyClaw/agent-inspector
-AGENT_INSPECTOR_JENKINS_NOTIFY_TOKEN=<jenkins-git-notify-token>
-AGENT_INSPECTOR_JENKINS_PUSH_DELAY_SECONDS=10
-```
-
-The hook writes local diagnostics to `.git/hooks/jenkins-pre-push.log`. The
-tracked template contains no secret values; every developer must configure their
-own token locally.
-
-For repositories that do not use Husky, install the same template as a native Git
-hook:
-
-```bash
-cp scripts/hooks/pre-push-jenkins-notify .git/hooks/pre-push
-chmod +x .git/hooks/pre-push
-```
-
-### Verified PR Workflow
-
-For local Jenkins instances that GitCode cannot reach, use the verified PR script
-instead of relying on GitCode WebHook delivery. The entire flow is outbound from
-the developer machine:
-
-1. Push the current commit to a temporary GitCode branch.
-2. Trigger the local Jenkins job with `GIT_REF=<temporary-branch>`.
-3. Wait for the Jenkins result.
-4. Create a GitCode Pull Request to `main` only when Jenkins returns `SUCCESS`.
-
-Configure local secrets once per clone:
-
-```powershell
-git config --local agentInspector.jenkinsUrl http://localhost:8080
-git config --local agentInspector.jenkinsJob agent-inspector-release
-git config --local agentInspector.jenkinsUser <jenkins-user>
-git config --local agentInspector.jenkinsApiToken <jenkins-api-token>
-git config --local agentInspector.gitcodeAccessToken <gitcode-access-token>
-git config --local agentInspector.gitcodeOwner TonyClaw
-git config --local agentInspector.gitcodeRepo agent-inspector
-```
-
-Then run:
-
-```powershell
-.\scripts\jenkins\verified-pr.ps1
-```
-
-The script pushes a branch named like `jenkins-verify/<user>/<sha>`, waits for
-Jenkins, and creates a PR through the GitCode API after a successful build. The
-temporary branch is kept as the PR source branch and is configured for deletion
-after merge when GitCode supports source-branch pruning.
+## Jenkins And GitCode
 
+Team CI, GitCode WebHook setup, Cloudflare Tunnel notes, local push fallback, and the verified PR workflow live in [Jenkins + GitCode WebHook](docs/JENKINS_GITCODE_WEBHOOK_TUNNEL.md). Keep real Jenkins notify tokens, GitCode access tokens, and tunnel URLs out of the repository.
 ## Project Direction
 
 Agent Inspector should stay close to the proven inspector codebase while growing into an agent knowledge layer. The memory flow has four layers:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",
@@ -57,6 +57,7 @@
     "format:check": "biome format .",
     "extension:zip": "node scripts/pack-chrome-extension.mjs",
     "extension:release": "node scripts/release-chrome-extension.mjs",
+    "release": "node scripts/release.mjs",
     "knip": "knip",
     "check": "bun format && bun typecheck && bun lint",
     "prepare": "husky",

package/src/cli/doctor.ts

@@ -1,7 +1,7 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { isAbsolute, join, resolve } from "node:path";
 import { createConnection } from "node:net";
-import { resolveDataDir } from "../proxy/dataDir";
+import { migrateLegacyDataDirs, resolveDataDir } from "../proxy/dataDir";
 
 const DEFAULT_PORT = 25947;
 const PROBE_TIMEOUT_MS = 2000;
@@ -32,6 +32,9 @@ export type DoctorOptions = {
   configDir: string | null;
   providersJson: string | null;
   chromeExtension: boolean;
+  fix: boolean;
+  json: boolean;
+  verbose: boolean;
   help: boolean;
 };
 
@@ -51,6 +54,7 @@ export type DoctorDeps = {
   readText: (path: string) => string | null;
   exists: (path: string) => boolean;
   listDir: (path: string) => readonly string[] | null;
+  stat: (path: string) => { isDirectory: boolean; size: number } | null;
   fetchHealth: (port: number) => Promise<HealthProbe>;
   isPortOpen: (port: number) => Promise<boolean>;
 };
@@ -89,6 +93,9 @@ export function parseDoctorArgs(
     configDir: null,
     providersJson: null,
     chromeExtension: false,
+    fix: false,
+    json: false,
+    verbose: false,
     help: false,
   };
 
@@ -132,6 +139,15 @@ export function parseDoctorArgs(
       case "--chrome-extension":
         options.chromeExtension = true;
         break;
+      case "--fix":
+        options.fix = true;
+        break;
+      case "--json":
+        options.json = true;
+        break;
+      case "--verbose":
+        options.verbose = true;
+        break;
       default:
         return { kind: "error", message: `doctor: unknown option ${arg}` };
     }
@@ -307,6 +323,112 @@ function checkPackage(rootDir: string, deps: DoctorDeps): DoctorCheck {
   }
 }
 
+function countFilesInDir(dir: string, deps: Pick<DoctorDeps, "listDir" | "stat">): number | null {
+  const files = deps.listDir(dir);
+  if (files === null) return null;
+  let count = 0;
+  for (const file of files) {
+    const fileStat = deps.stat(join(dir, file));
+    if (fileStat !== null && !fileStat.isDirectory) count += 1;
+  }
+  return count;
+}
+
+function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
+  if (bytes < 1024 * 1024 * 1024) return `${(bytes / 1024 / 1024).toFixed(1)} MiB`;
+  return `${(bytes / 1024 / 1024 / 1024).toFixed(1)} GiB`;
+}
+
+function dirSize(
+  dir: string,
+  deps: Pick<DoctorDeps, "listDir" | "stat">,
+  depth = 0,
+): number | null {
+  const dirStat = deps.stat(dir);
+  if (dirStat === null) return null;
+  if (!dirStat.isDirectory) return dirStat.size;
+  if (depth > 4) return 0;
+
+  const files = deps.listDir(dir);
+  if (files === null) return null;
+  let total = 0;
+  for (const file of files) {
+    const childSize = dirSize(join(dir, file), deps, depth + 1);
+    if (childSize !== null) total += childSize;
+  }
+  return total;
+}
+
+function verboseChecks(options: DoctorOptions, deps: DoctorDeps): readonly DoctorCheck[] {
+  const dataDir = resolveDefaultDataDir(deps.env, deps.platform, deps.exists);
+  const logsDir = join(dataDir, "logs");
+  const chunksDir = join(dataDir, "chunks");
+  const providerCandidates = providerConfigCandidates(options, deps);
+  const captureMode =
+    deps.env["AGENT_INSPECTOR_MODE"] ?? deps.env["AGENT_INSPECTOR_CAPTURE_MODE"] ?? "simple";
+  const logCount = countFilesInDir(logsDir, deps);
+  const logSize = dirSize(logsDir, deps);
+  const chunkSize = dirSize(chunksDir, deps);
+  const homeDir =
+    deps.platform === "win32"
+      ? (deps.env["USERPROFILE"] ?? deps.env["APPDATA"] ?? null)
+      : (deps.env["HOME"] ?? null);
+  const claudeSkill =
+    homeDir === null
+      ? null
+      : join(homeDir, ".claude", "skills", "agent-inspector-onboard", "SKILL.md");
+  const claudeCommand =
+    homeDir === null ? null : join(homeDir, ".claude", "commands", "agent-inspector-onboard.md");
+  const codexSkill =
+    homeDir === null
+      ? null
+      : join(homeDir, ".codex", "skills", "agent-inspector-onboard", "SKILL.md");
+  const hasClaudeOnboarding =
+    claudeSkill !== null &&
+    claudeCommand !== null &&
+    deps.exists(claudeSkill) &&
+    deps.exists(claudeCommand);
+  const hasCodexOnboarding = codexSkill !== null && deps.exists(codexSkill);
+
+  return [
+    check("Data directory", "pass", dataDir),
+    check("Provider config search", "pass", providerCandidates.join(", ")),
+    check("Capture mode env", "pass", captureMode),
+    check(
+      "Log storage",
+      logCount === null ? "warn" : "pass",
+      logCount === null
+        ? `Log directory was not found or could not be read: ${logsDir}`
+        : `${logCount} file(s), ${formatBytes(logSize ?? 0)} under ${logsDir}`,
+    ),
+    check(
+      "Chunk storage",
+      chunkSize === null ? "warn" : "pass",
+      chunkSize === null
+        ? `Chunk directory was not found or could not be read: ${chunksDir}`
+        : `${formatBytes(chunkSize)} under ${chunksDir}`,
+    ),
+    check(
+      "Claude onboarding",
+      hasClaudeOnboarding ? "pass" : "warn",
+      hasClaudeOnboarding
+        ? "Claude Code skill and slash command are installed."
+        : "Claude Code onboarding files were not found.",
+      "Run `agent-inspector onboard --force` after installing or upgrading.",
+    ),
+    check(
+      "Codex onboarding",
+      hasCodexOnboarding ? "pass" : "warn",
+      hasCodexOnboarding
+        ? "Codex onboarding skill is installed."
+        : "Codex onboarding skill was not found.",
+      "Run `agent-inspector onboard --force` after installing or upgrading.",
+    ),
+  ];
+}
+
 function checkExtensionSource(rootDir: string, deps: DoctorDeps): DoctorCheck {
   const extensionDir = join(rootDir, "extensions", "chrome");
   const missing = EXTENSION_REQUIRED_FILES.filter((file) => !deps.exists(join(extensionDir, file)));
@@ -406,9 +528,12 @@ export async function buildDoctorReport(
     checkProviderConfig(options, deps),
     checkPackage(rootDir, deps),
   ];
-  const checks = options.chromeExtension
+  const checksWithExtension = options.chromeExtension
     ? [...coreChecks, checkExtensionSource(rootDir, deps), checkExtensionPackage(rootDir, deps)]
     : coreChecks;
+  const checks = options.verbose
+    ? [...checksWithExtension, ...verboseChecks(options, deps)]
+    : checksWithExtension;
 
   const passCount = checks.filter((item) => item.severity === "pass").length;
   const warnCount = checks.filter((item) => item.severity === "warn").length;
@@ -438,14 +563,21 @@ export function formatDoctorReport(report: DoctorReport): string {
   return `${lines.join("\n")}\n`;
 }
 
+export function formatDoctorJson(report: DoctorReport): string {
+  return `${JSON.stringify(report, null, 2)}\n`;
+}
+
 export function doctorHelp(): string {
   return [
     "agent-inspector doctor",
     "",
     "Usage:",
-    "  agent-inspector doctor [--port <port>] [--config-dir <dir>] [--providers <json>] [--chrome-extension]",
+    "  agent-inspector doctor [--port <port>] [--config-dir <dir>] [--providers <json>] [--fix] [--json] [--verbose] [--chrome-extension]",
     "",
     "Checks local proxy health, provider config presence, and package metadata.",
+    "Pass --fix to run safe local repairs before checks, including legacy data-dir migration.",
+    "Pass --json to emit a machine-readable report for CI, scripts, and Jenkins.",
+    "Pass --verbose to include local paths, capture mode, and log storage checks.",
     "Pass --chrome-extension to also check Chrome companion source and packaged artifacts.",
     "",
   ].join("\n");
@@ -499,6 +631,15 @@ function listDir(path: string): readonly string[] | null {
   }
 }
 
+function stat(path: string): { isDirectory: boolean; size: number } | null {
+  try {
+    const fileStat = statSync(path);
+    return { isDirectory: fileStat.isDirectory(), size: fileStat.size };
+  } catch {
+    return null;
+  }
+}
+
 export function createDoctorDeps(): DoctorDeps {
   return {
     env: process.env,
@@ -507,6 +648,7 @@ export function createDoctorDeps(): DoctorDeps {
     exists: existsSync,
     readText,
     listDir,
+    stat,
     fetchHealth,
     isPortOpen,
   };
@@ -522,7 +664,10 @@ export async function runDoctor(argv: readonly string[]): Promise<number> {
     process.stdout.write(doctorHelp());
     return 0;
   }
+  if (parsed.options.fix) {
+    migrateLegacyDataDirs();
+  }
   const report = await buildDoctorReport(parsed.options);
-  process.stdout.write(formatDoctorReport(report));
+  process.stdout.write(parsed.options.json ? formatDoctorJson(report) : formatDoctorReport(report));
   return report.exitCode;
 }

package/src/components/OnboardingBanner.tsx

@@ -25,41 +25,41 @@ export function OnboardingBanner(): JSX.Element | null {
             ? "Agent Inspector is ready in Full mode"
             : "Agent Inspector is ready in Simple mode"}
         </div>
-        <ul className="space-y-0.5 text-xs leading-relaxed text-muted-foreground">
+        <ol className="space-y-0.5 text-xs leading-relaxed text-muted-foreground">
+          <li>
+            <strong>1. Start in the right mode</strong>: this process is currently running in{" "}
+            <code>{captureMode}</code>. Mode is fixed at startup.
+          </li>
           {isFullMode ? (
             <>
               <li>
-                <strong>Full mode</strong>: raw headers, raw response, and SSE chunks are captured
-                for diagnostics.
+                <strong>2. Full diagnostics</strong>: raw headers, raw response, and SSE chunks are
+                captured for deep investigations.
               </li>
               <li>
-                <strong>Daily work</strong>: restart with <code>agent-inspector --mode simple</code>{" "}
-                to reduce capture overhead.
+                <strong>3. Daily work</strong>: restart with{" "}
+                <code>agent-inspector --mode simple</code> to reduce capture overhead.
               </li>
             </>
           ) : (
             <>
               <li>
-                <strong>Simple mode</strong>: lightweight capture for requests, responses, tools,
-                timing, and token usage.
+                <strong>2. Simple capture</strong>: requests, responses, tools, timing, tokens,
+                replay, and memory candidates are available with lower overhead.
               </li>
               <li>
-                <strong>Need diagnostics?</strong> Restart with{" "}
+                <strong>3. Need raw diagnostics?</strong> Restart with{" "}
                 <code>agent-inspector --mode full</code> for raw headers, raw response, and SSE
                 chunks.
               </li>
             </>
           )}
-          <li>
-            <strong>Replay and Memory</strong>: available in both modes for provider checks and
-            reviewable knowledge candidates.
-          </li>
           <li>
             <strong>Agent setup</strong>: run <code>agent-inspector onboard --status</code>, then
             use <code>/agent-inspector:onboard</code> in Claude Code or ask Codex to use{" "}
             <code>agent-inspector-onboard</code>.
           </li>
-        </ul>
+        </ol>
       </div>
       <button
         type="button"