@tonyclaw/agent-inspector 2.0.17 → 2.0.19

package/.output/server/{_tanstack-start-manifest_v-CuiFi3XC.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-bwZlEXw2.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-u-LwDaeH.js", "/assets/ProxyViewerContainer-DbbK1y7N.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-gv1a_NNu.js", "/assets/ProxyViewerContainer-DbbK1y7N.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-bwZlEXw2.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:05:44.395Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/CompareDrawer-DDg7Cs4N.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"49fe-ST4mvhJApf3tK3AHGe/jnh7b8dA"',
-    "mtime": "2026-06-27T08:05:44.395Z",
-    "size": 18942,
-    "path": "../public/assets/CompareDrawer-DDg7Cs4N.js"
-  },
-  "/assets/index-D_nZj9Vt.css": {
+  "/assets/index-BfBgrkgU.css": {
     "type": "text/css; charset=utf-8",
-    "etag": '"1a275-7T1iSNG2p6BSsqLwdpfky+9evLw"',
-    "mtime": "2026-06-27T08:05:44.395Z",
-    "size": 107125,
-    "path": "../public/assets/index-D_nZj9Vt.css"
+    "etag": '"1a2c9-oAW5yRzaizIi778RSlqZhPc85Pw"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 107209,
+    "path": "../public/assets/index-BfBgrkgU.css"
   },
-  "/assets/index-u-LwDaeH.js": {
+  "/assets/index-BbFsmQRC.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"74-boh/9GDh4CR9Flgsc4G84xDxjHg"',
-    "mtime": "2026-06-27T08:05:44.395Z",
+    "etag": '"74-vI6w+1iyboIWfJVk8/ech/2b8UY"',
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 116,
-    "path": "../public/assets/index-u-LwDaeH.js"
+    "path": "../public/assets/index-BbFsmQRC.js"
   },
-  "/assets/ReplayDialog-C1zWNkoz.js": {
+  "/assets/CompareDrawer-D-90PIPw.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"2361-2HHZgW4drPSmavIm8hPSIOojqNs"',
-    "mtime": "2026-06-27T08:05:44.396Z",
-    "size": 9057,
-    "path": "../public/assets/ReplayDialog-C1zWNkoz.js"
-  },
-  "/assets/RequestAnatomy-DR8OICOJ.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-N9GhW/2QqcCw31XDu4TtvnszBGI"',
-    "mtime": "2026-06-27T08:05:44.396Z",
-    "size": 17541,
-    "path": "../public/assets/RequestAnatomy-DR8OICOJ.js"
+    "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:05:44.395Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/ResponseView-Dh9iSj6h.js": {
+  "/assets/ReplayDialog-DzlLYoTO.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"30cd-4xMnhGLUg/50P9M4/lNZVL4lKjo"',
-    "mtime": "2026-06-27T08:05:44.396Z",
-    "size": 12493,
-    "path": "../public/assets/ResponseView-Dh9iSj6h.js"
+    "etag": '"318c-bOjCbSP/w/aeX1kn9QRZtFGLMFY"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 12684,
+    "path": "../public/assets/ReplayDialog-DzlLYoTO.js"
   },
-  "/assets/zhipuai-BPNAnxo-.svg": {
-    "type": "image/svg+xml",
-    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-27T08:05:44.395Z",
-    "size": 11256,
-    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
+  "/assets/RequestAnatomy-0hbyf6oa.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"4485-EusuohynIBF0h9+uJ+g1znFjMpc"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 17541,
+    "path": "../public/assets/RequestAnatomy-0hbyf6oa.js"
   },
-  "/assets/StreamingChunkSequence-B_xElyH3.js": {
+  "/assets/StreamingChunkSequence-enhfdeNh.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d5b-63IZqsXb3mHwoP35jfQARaDbClI"',
-    "mtime": "2026-06-27T08:05:44.396Z",
-    "size": 3419,
-    "path": "../public/assets/StreamingChunkSequence-B_xElyH3.js"
+    "etag": '"d57-tC/D5hLCBdTaOabqUAFaXVthebA"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 3415,
+    "path": "../public/assets/StreamingChunkSequence-enhfdeNh.js"
   },
-  "/assets/_sessionId-gv1a_NNu.js": {
+  "/assets/ResponseView-CKe0tNqr.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-atc0PPwWYseoheB1VLGM7JAiJ/A"',
-    "mtime": "2026-06-27T08:05:44.395Z",
+    "etag": '"30d0-N2ASszGo1KTiM+aCCKGHlqvDV+0"',
+    "mtime": "2026-06-29T02:52:50.787Z",
+    "size": 12496,
+    "path": "../public/assets/ResponseView-CKe0tNqr.js"
+  },
+  "/assets/_sessionId-CJ-SusES.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"d2-B/4bxwxZCrYG2uo6f9Vw/Iubu34"',
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-gv1a_NNu.js"
+    "path": "../public/assets/_sessionId-CJ-SusES.js"
+  },
+  "/assets/zhipuai-BPNAnxo-.svg": {
+    "type": "image/svg+xml",
+    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
+    "mtime": "2026-06-29T02:52:50.786Z",
+    "size": 11256,
+    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/main-bwZlEXw2.js": {
+  "/assets/main-o9-hg8g1.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"51726-1SJJ0BJfAuGmylFZ/0OY4VxlOhE"',
-    "mtime": "2026-06-27T08:05:44.395Z",
+    "etag": '"51726-j0zx0pW0MFG6YpQKGgNUrH681sU"',
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 333606,
-    "path": "../public/assets/main-bwZlEXw2.js"
+    "path": "../public/assets/main-o9-hg8g1.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-27T08:05:44.395Z",
+    "mtime": "2026-06-29T02:52:50.786Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-DbbK1y7N.js": {
+  "/assets/ProxyViewerContainer-CxRDWacg.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"aa779-gGe0kXBI3ePH3bRC96W2oCbRTJ4"',
-    "mtime": "2026-06-27T08:05:44.396Z",
-    "size": 698233,
-    "path": "../public/assets/ProxyViewerContainer-DbbK1y7N.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

@@ -80,6 +80,21 @@ bun install
 bun run dev
 ```
 
+Run a local health check when you need to verify the proxy and installed
+configuration:
+
+```bash
+agent-inspector doctor
+```
+
+The default doctor check covers proxy health, provider configuration, and
+package metadata. Chrome companion source and zip artifacts are optional and
+only checked when you ask for them explicitly:
+
+```bash
+agent-inspector doctor --chrome-extension
+```
+
 Then point an AI coding tool at the proxy:
 
 ```bash
@@ -88,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:
@@ -118,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.17",
+  "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;
@@ -31,6 +31,10 @@ export type DoctorOptions = {
   port: number;
   configDir: string | null;
   providersJson: string | null;
+  chromeExtension: boolean;
+  fix: boolean;
+  json: boolean;
+  verbose: boolean;
   help: boolean;
 };
 
@@ -50,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>;
 };
@@ -87,6 +92,10 @@ export function parseDoctorArgs(
     port: envPort ?? DEFAULT_PORT,
     configDir: null,
     providersJson: null,
+    chromeExtension: false,
+    fix: false,
+    json: false,
+    verbose: false,
     help: false,
   };
 
@@ -127,6 +136,18 @@ export function parseDoctorArgs(
         i++;
         break;
       }
+      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}` };
     }
@@ -302,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)));
@@ -396,13 +523,17 @@ export async function buildDoctorReport(
   deps: DoctorDeps = createDoctorDeps(),
 ): Promise<DoctorReport> {
   const rootDir = findProjectRoot(deps.cwd, deps);
-  const checks = [
+  const coreChecks = [
     await checkProxyHealth(options.port, deps),
     checkProviderConfig(options, deps),
     checkPackage(rootDir, deps),
-    checkExtensionSource(rootDir, deps),
-    checkExtensionPackage(rootDir, deps),
   ];
+  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;
@@ -432,14 +563,22 @@ 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>]",
+    "  agent-inspector doctor [--port <port>] [--config-dir <dir>] [--providers <json>] [--fix] [--json] [--verbose] [--chrome-extension]",
     "",
-    "Checks local proxy health, provider config presence, package metadata, and Chrome companion readiness.",
+    "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");
 }
@@ -492,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,
@@ -500,6 +648,7 @@ export function createDoctorDeps(): DoctorDeps {
     exists: existsSync,
     readText,
     listDir,
+    stat,
     fetchHealth,
     isPortOpen,
   };
@@ -515,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;
 }