pi-webapp 0.1.10 → 0.1.12

package/docs/sentry-triage.md

@@ -0,0 +1,75 @@
+# 用 Sentry CLI + Codex 分析已有问题
+
+在仓库根目录运行。流程读取 Sentry 的 Issue 和多个事件样本，让 Codex 对照本地源码分析，生成中文 Markdown 和结构化 JSON 报告。它不修改应用代码或 Sentry 问题状态，也不调用 Seer。
+
+## 首次准备
+
+```sh
+npm install -g sentry
+sentry auth login --read-only
+sentry auth status
+codex login status
+```
+
+需要官方 `sentry` CLI（不是旧的 `sentry-cli` 命令）和已登录的 Codex CLI。账号须能读取目标组织和项目。OAuth 凭据由 CLI 保存，不写入仓库。Codex 使用用户现有的模型和登录配置；分析会消耗正常 Codex 使用额度。
+
+## 运行
+
+```sh
+# 最近 7 天仍未解决的问题：最多 20 个，每个最多读取 3 个事件
+npm run sentry:triage
+
+# 调整范围。按发生次数排序；limit 最大 1000
+npm run sentry:triage -- --period 30d --limit 50 --events 5
+
+# 专门看 edit 工具的未知失败
+npm run sentry:triage -- --query 'is:unresolved toolName:edit failureKind:unknown'
+
+# 只拉取证据，在当前 Codex 聊天中分析，或稍后重用
+npm run sentry:triage -- --collect-only
+
+# 重用已有证据，不再访问 Sentry
+npm run sentry:triage -- --input artifacts/sentry-triage/run-XXXXXX/evidence.json
+
+# 也支持 Sentry 下载的单个原始事件 JSON
+npm run sentry:triage -- --input /absolute/path/event.json
+```
+
+默认目标为 `soft/pi-webapp`，可用 `--project org/project` 更改。默认排除 `sentry-verification`，自定义 Issue 查询会替换默认查询。事件采样始终排除验证环境。
+
+每次创建独立的 `artifacts/sentry-triage/run-*` 目录，避免覆盖之前的结果。`artifacts/` 已被 Git 忽略。
+
+| 文件 | 内容 |
+| --- | --- |
+| `evidence.json` | Issue 摘要、事件异常和 breadcrumbs、诊断上下文、采样范围 |
+| `prompt.md` | 本次分析的规则和输入位置 |
+| `report.schema.json` | 结构化输出格式 |
+| `report.json` / `report.md` | 已校验的分类、修复判断、证据、代码位置和下一步 |
+| `analysis.json` / `codex.log` | Codex 原始分析结果及运行日志；失败时不一定存在 |
+
+报告只在完整性校验通过后写出。Issue 列表查询失败会直接退出；某个 Issue 的事件读取失败会记录采集限制，要求对该 Issue 判为证据不足，不能悄悄丢弃。
+
+## 判断规则
+
+| 分类 | 含义 |
+| --- | --- |
+| `app_bug` | 有证据支持的 pi-webapp 程序缺陷 |
+| `dependency_or_external` | Pi、插件、网络或外部服务问题 |
+| `expected_tool_failure` | 已识别的正常工具失败结果；不代表用户任务成功 |
+| `monitoring_gap` | 错误分类、上报级别、重复采集或诊断信息的缺口 |
+| `insufficient_evidence` | 无法确认根因，需要补充证据 |
+
+修复判断为 `fix`、`no_fix`、`monitor` 或 `investigate`，同时输出 P0–P3 优先级和 high/medium/low 置信度。分类是模型的有证据分析，仍需审阅。脚本校验枚举、Issue 覆盖和部分判断约束，不能代替对根因的验证。
+
+每个 Issue 有一个主要结论，并允许附带独立发现。例如 `edit: unknown` 的实际失败原因可以判为证据不足，同时建议补充监控分类；不能把两者合并成“已确认编辑功能 BUG”。
+
+## 数据和范围
+
+- 默认分析最近活跃的未解决问题，不是所有历史错误。需要分析已解决问题时使用自定义 `--query`。
+- `issueLimitReached` 为 true 时，可能还有未读取的 Issue；增加 `--limit` 或缩小查询范围。每个 Issue 的事件是近期样本，不是随机采样，也不保证覆盖所有版本。
+- `count`、`lifetime` 和所选时间内的统计可能不同；采集限流也会少计事件。用户数为 0 不能证明没有影响用户，`handled=true` 不能证明没有功能故障。
+- 报告记录本地 Git revision。工作区可能含未提交修改，本地代码不一定等于事件发布版本。报告应说明版本匹配的证据或限制。
+- 不保留事件中的 request、user、附件、frame vars 或任意 extra 字段。异常文本与 breadcrumbs 仍可能含业务信息；证据、报告及运行日志是本地诊断资料，不进入 Git 或 npm 包。Codex 会读取这些证据并通过当前配置的模型服务分析。
+- Codex 用 `--sandbox read-only` 分析源码，最终报告由宿主脚本保存。规则禁止在分析中修改代码、更新 Sentry、发消息或读取凭据。无需在 pi-webapp 运行时配置查询凭据。
+
+参考：[Sentry CLI 安装](https://cli.sentry.dev/getting-started/)、[Issue 命令](https://cli.sentry.dev/commands/issue/)、[Codex 非交互运行](https://learn.chatgpt.com/docs/non-interactive-mode)。

package/docs/sentry.md

@@ -26,6 +26,8 @@ Browser events go directly to the configured Sentry host with no Pi authorizatio
 
 ## Diagnosing a tool failure
 
+For CLI + Codex analysis of existing issues, including classifications and repair decisions, see [Sentry triage](sentry-triage.md). Run `npm run sentry:triage` from the repository after authenticating the Sentry and Codex CLIs.
+
 Both TUI and SDK workspace sessions observe `tool_execution_start/end`. A failed `message_end` is a fallback only: the same tool call is not reported twice. Tool execution behavior and visible results are unchanged.
 
 | Diagnostic field | Meaning |
@@ -53,6 +55,8 @@ Filter Sentry by `side:node`, `toolName`, `failureKind` and `errorCode`, then in
 
 ## Performance and reliability
 
+After an accepted update, browser version polling retains temporary network failures as `request_failed` breadcrumbs while waiting for the restarted service. If the target version is still unavailable after 60 seconds, it stops polling and reports one `stage=update_restart`, `code=update_restart_timeout` error, even if a request is still pending. Closing settings cancels the pending request and deadline. HTTP and response parsing failures, and network failures from other requests, retain normal reporting.
+
 Each side sends at most 20 events/minute and one event per fingerprint/minute. Repetition counts appear on the next retained event. Startup and transport queues are bounded to 20 events. Transport requests time out after 3 seconds, do not persist offline, and do not retry indefinitely. Rate-limited/dropped events are intentionally lossy. Browser configuration has a 1-second timeout and never gates rendering; SDKs load only when reporting is enabled. No tracing, profiling, automatic console/DOM instrumentation or token-by-token logging is enabled.
 
 Request failures and asynchronous error events include additive `errorId`, `requestId`, `operationId`, `errorCode` and `errorReported` metadata. `errorReported` prevents the browser from bypassing server-side deduplication/rate limits. Protocol version 7 is retained. A `shutdown` event stops reconnection on normal exit; controlled launcher upgrades mark it with `reconnect: true` so the browser reconnects without reporting the expected interruption. A changed build ID replaces a retained bridge on `/web` after `/reload` so its static manifest matches the new assets.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-webapp",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "type": "module",
   "description": "A browser interface for Pi with live chat, workspaces, models, and attachments",
   "repository": {
@@ -15,7 +15,7 @@
     "pi-webapp": "./bin/pi-webapp.mjs"
   },
   "pi": {
-    "image": "https://cdn.jsdelivr.net/npm/pi-webapp@0.1.10/assets/cover-webapp.png",
+    "image": "https://cdn.jsdelivr.net/npm/pi-webapp@0.1.12/assets/cover-webapp.png",
     "extensions": [
       "./dist/extension.js"
     ]
@@ -29,7 +29,8 @@
     "README.zh-CN.md",
     "LICENSE",
     "web/src/ui/shared/LICENSE.txt",
-    "docs/sentry.md"
+    "docs/sentry.md",
+    "docs/sentry-triage.md"
   ],
   "scripts": {
     "start": "npm run build && node bin/pi-webapp.mjs",
@@ -45,6 +46,7 @@
     "build:sentry": "node scripts/build.mjs all --sentry",
     "verify:package": "node scripts/verify-sentry-release.mjs --package-only",
     "verify:sentry": "node scripts/verify-sentry-release.mjs --live",
+    "sentry:triage": "node scripts/sentry-triage.mjs",
     "test:browser": "playwright test"
   },
   "publishConfig": {

package/web/dist/.vite/manifest.json

@@ -122,13 +122,13 @@
     "isDynamicEntry": true
   },
   "../../node_modules/@shikijs/langs/dist/graphql.mjs": {
-    "file": "assets/graphql-DvPK7yuL.js",
+    "file": "assets/graphql-IPoCyjbx.js",
     "name": "graphql",
     "src": "../../node_modules/@shikijs/langs/dist/graphql.mjs",
     "isDynamicEntry": true,
     "imports": [
       "_javascript-D_ijBMSX.js",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "index.html"
     ]
   },
@@ -161,12 +161,12 @@
     ]
   },
   "../../node_modules/@shikijs/langs/dist/http.mjs": {
-    "file": "assets/http-B5WHvjtS.js",
+    "file": "assets/http-k59Hanmf.js",
     "name": "http",
     "src": "../../node_modules/@shikijs/langs/dist/http.mjs",
     "isDynamicEntry": true,
     "imports": [
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/xml.mjs",
       "../../node_modules/@shikijs/langs/dist/graphql.mjs",
       "index.html",
@@ -275,7 +275,7 @@
     ]
   },
   "../../node_modules/@shikijs/langs/dist/php.mjs": {
-    "file": "assets/php-s52DiJil.js",
+    "file": "assets/php-BG9P_ECJ.js",
     "name": "php",
     "src": "../../node_modules/@shikijs/langs/dist/php.mjs",
     "isDynamicEntry": true,
@@ -284,7 +284,7 @@
       "../../node_modules/@shikijs/langs/dist/xml.mjs",
       "../../node_modules/@shikijs/langs/dist/sql.mjs",
       "_javascript-D_ijBMSX.js",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/css.mjs",
       "../../node_modules/@shikijs/langs/dist/java.mjs",
       "index.html"
@@ -315,7 +315,7 @@
     "isDynamicEntry": true
   },
   "../../node_modules/@shikijs/langs/dist/rst.mjs": {
-    "file": "assets/rst-CN3AX0Wt.js",
+    "file": "assets/rst-Rxh6XweC.js",
     "name": "rst",
     "src": "../../node_modules/@shikijs/langs/dist/rst.mjs",
     "isDynamicEntry": true,
@@ -324,7 +324,7 @@
       "../../node_modules/@shikijs/langs/dist/cpp.mjs",
       "../../node_modules/@shikijs/langs/dist/python.mjs",
       "_javascript-D_ijBMSX.js",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/yaml.mjs",
       "../../node_modules/@shikijs/langs/dist/cmake.mjs",
       "../../node_modules/@shikijs/langs/dist/ruby.mjs",
@@ -340,7 +340,7 @@
     ]
   },
   "../../node_modules/@shikijs/langs/dist/ruby.mjs": {
-    "file": "assets/ruby-TeaxAh4o.js",
+    "file": "assets/ruby-vsmpeItB.js",
     "name": "ruby",
     "src": "../../node_modules/@shikijs/langs/dist/ruby.mjs",
     "isDynamicEntry": true,
@@ -353,7 +353,7 @@
       "../../node_modules/@shikijs/langs/dist/graphql.mjs",
       "../../node_modules/@shikijs/langs/dist/cpp.mjs",
       "../../node_modules/@shikijs/langs/dist/c.mjs",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/lua.mjs",
       "../../node_modules/@shikijs/langs/dist/yaml.mjs",
       "../../node_modules/@shikijs/langs/dist/java.mjs",
@@ -388,13 +388,13 @@
     "isDynamicEntry": true
   },
   "../../node_modules/@shikijs/langs/dist/svelte.mjs": {
-    "file": "assets/svelte-D-qO2kbs.js",
+    "file": "assets/svelte-BbsEXeJC.js",
     "name": "svelte",
     "src": "../../node_modules/@shikijs/langs/dist/svelte.mjs",
     "isDynamicEntry": true,
     "imports": [
       "_javascript-D_ijBMSX.js",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/css.mjs",
       "index.html"
     ]
@@ -430,14 +430,14 @@
     "isDynamicEntry": true
   },
   "../../node_modules/@shikijs/langs/dist/vue.mjs": {
-    "file": "assets/vue-xQhdtb6A.js",
+    "file": "assets/vue-DgFjFt96.js",
     "name": "vue",
     "src": "../../node_modules/@shikijs/langs/dist/vue.mjs",
     "isDynamicEntry": true,
     "imports": [
       "../../node_modules/@shikijs/langs/dist/css.mjs",
       "_javascript-D_ijBMSX.js",
-      "_app-B2Ac56ic.js",
+      "_app-Boh5DRzv.js",
       "../../node_modules/@shikijs/langs/dist/html.mjs",
       "_html-derivative-CADUTaWI.js",
       "index.html"
@@ -694,8 +694,8 @@
     "file": "assets/KaTeX_Typewriter-Regular.woff2",
     "src": "../../node_modules/katex/dist/fonts/KaTeX_Typewriter-Regular.woff2"
   },
-  "_app-B2Ac56ic.js": {
-    "file": "assets/app-B2Ac56ic.js",
+  "_app-Boh5DRzv.js": {
+    "file": "assets/app-Boh5DRzv.js",
     "name": "app",
     "isDynamicEntry": true,
     "imports": [
@@ -840,7 +840,7 @@
     "isEntry": true,
     "dynamicImports": [
       "telemetry-client.ts",
-      "_app-B2Ac56ic.js"
+      "_app-Boh5DRzv.js"
     ]
   },
   "style.css": {