dsh-my-observability 0.1.7 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 本文件记录 dsh-my-observability 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [Unreleased]
+
+### 变更
+
+- refactor(observability): #198 资源看门狗改为消费 `dsh-shared` 的 `createResourceGuard`（第三批）——插件私有状态机/判定/ring buffer 删除，只保留宿主职责（采样源 + $DSH_HOME 字节维度 + 降级动作）。行为等价：降级在第 3 个连续超限窗口触发、恢复在第 3 个连续正常窗口触发、回调恰好一次、告警规则与顺序不变；新增 `monitor.stats()` / `monitor.history()` 与可注入采样源/时钟（确定性测试）
+
+## [0.3.1] - 2026-09-10
+
+### 变更
+
+- feat(ts): 第四轮 JS→TS 迁移（5 个插件，server + client 全量）
+
+## [0.3.0] - 2026-09-07
+
+### 变更
+
+- feat(observability): #155 错误上报统一——plugin_error 事件类型 + /errors API (#177)
+- feat(observability): #155 资源监控扩展——新增 $DSH_HOME 目录总大小监控 (#176)
+- feat(observability): #155 插件状态查询聚合——统一 status-query 事件 + /plugin-status API (#170)
+- chore(plugins): #165 清理失效的 dsh.client.inject 声明（13 插件） (#167)
+
+## [0.2.0] - 2026-09-07
+
+### 变更
+
+- feat(observability): #155 错误上报统一——plugin_error 事件类型 + /errors API (#177)
+- feat(observability): #155 资源监控扩展——新增 $DSH_HOME 目录总大小监控 (#176)
+- feat(observability): #155 插件状态查询聚合——统一 status-query 事件 + /plugin-status API (#170)
+- chore(plugins): #165 清理失效的 dsh.client.inject 声明（13 插件） (#167)
+
 ## [0.1.7] - 2026-09-06
 
 ### 变更

package/README.md

@@ -61,7 +61,7 @@ Server 端只读观察 DSH 生命周期事件并记录审计日志：
 ## 工作原理
 
 - **Server 端**（`lib/index.js`）：`audit.js` 监听四类事件 → `store.js` 按会话分桶持久化；`git.js` 类型化提交（execFile）；`review.js` + `diff.js` 规则引擎；`ai.js` 可选 AI 增强；`routes.js` 提供 `/observability/api` 路由（全部经 loopback 信任围栏）。
-- **Client 端**（`lib/client.js`）：两个侧边栏页签（`dsh-my-observability:replay` 轨迹回放、`dsh-my-observability:git` Git 工具），样式走 DSH 语义 token，随 fiber 卸载无残留。
+- **Client 端**（`lib/client.js`）：两个侧边栏页签（`dsh-my-observability:replay` 轨迹回放、`dsh-my-observability:git` Git 工具），每个面板一个页签类型，经**宿主原生侧边栏扩展点**注册（`ctx.sidebarRightTabs` 页签类型 + `slots` 的 `sidebar.right.pane.tab` / `.title` 席位，issue #187 批 1），样式走 DSH 语义 token，随 fiber 卸载无残留。
 
 ## 安装
 

package/lib/ai.js

@@ -10,67 +10,69 @@
  * 参考 dsh-task-reliability 的校验 agent 模式（agents.create + whenIdle
  * 超时 + dispose）。
  */
-import { randomUUID } from 'node:crypto'
-import { withTimeout, userMessage } from 'dsh-shared'
-import { REVIEW_TIMEOUT_MS } from './constants.js'
-
+import { randomUUID } from 'node:crypto';
+import { withTimeout, userMessage } from 'dsh-shared';
+import { REVIEW_TIMEOUT_MS } from './constants.js';
 /** diff 送入 prompt 的最大长度（截断防 token 爆炸）。 */
-const AI_DIFF_MAX = 8000
-
+const AI_DIFF_MAX = 8000;
 /** 运行 AI 审查（尽力而为；任何失败都降级为 failed 标记）。 */
 export async function runAiReview(ctx, diffText, report, timeoutMs = REVIEW_TIMEOUT_MS) {
-  const agents = agentsServiceOf(ctx)
-  if (agents === undefined) return { enabled: true, failed: true, note: 'agents service unavailable' }
-  // CodeQL js/insecure-randomness 修复：sessionId 随机段改用 crypto.randomUUID()
-  // （密码学安全随机，无需种子），保持 `obs-review-<ts>-<6位hex>` 格式兼容。
-  const sessionId = `obs-review-${Date.now()}-${randomUUID().slice(0, 6)}`
-  let handle
-  try {
-    handle = await agents.create({
-      sessionId,
-      meta: { origin: 'subagent', delegationDepth: 1 },
-      agentOptions: {},
-    })
-    handle.agent.followup(userMessage(aiReviewPrompt(diffText, report)))
-    await withTimeout(handle.agent.whenIdle(), timeoutMs)
-    const parsed = parseAiConclusion(lastAssistantText(handle.agent.session))
-    if (parsed === undefined) return { enabled: true, failed: true, note: 'AI 结论解析失败' }
-    return { enabled: true, ...parsed }
-  } catch (error) {
-    return {
-      enabled: true,
-      failed: true,
-      note: error instanceof Error ? error.message : String(error),
+    const agents = agentsServiceOf(ctx);
+    if (agents === undefined)
+        return { enabled: true, failed: true, note: 'agents service unavailable' };
+    // CodeQL js/insecure-randomness 修复：sessionId 随机段改用 crypto.randomUUID()
+    // （密码学安全随机，无需种子），保持 `obs-review-<ts>-<6位hex>` 格式兼容。
+    const sessionId = `obs-review-${Date.now()}-${randomUUID().slice(0, 6)}`;
+    let handle;
+    try {
+        handle = await agents.create({
+            sessionId,
+            meta: { origin: 'subagent', delegationDepth: 1 },
+            agentOptions: {},
+        });
+        handle.agent.followup(userMessage(aiReviewPrompt(diffText, report)));
+        await withTimeout(handle.agent.whenIdle(), timeoutMs);
+        const parsed = parseAiConclusion(lastAssistantText(handle.agent.session));
+        if (parsed === undefined)
+            return { enabled: true, failed: true, note: 'AI 结论解析失败' };
+        return { enabled: true, ...parsed };
+    }
+    catch (error) {
+        return {
+            enabled: true,
+            failed: true,
+            note: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        await disposeHandle(handle);
     }
-  } finally {
-    await disposeHandle(handle)
-  }
 }
-
 /** agents 服务读取（不可用返回 undefined）。 */
 function agentsServiceOf(ctx) {
-  const agents = ctx.get ? ctx.get('agents') : undefined
-  if (agents === undefined || agents === null || typeof agents.create !== 'function') return undefined
-  return agents
+    const agents = ctx.get ? ctx.get('agents') : undefined;
+    if (agents === undefined || agents === null || typeof agents.create !== 'function')
+        return undefined;
+    return agents;
 }
-
 /** 释放审查 agent（尽力而为）。 */
 async function disposeHandle(handle) {
-  if (handle === undefined) return
-  try {
-    await handle.dispose()
-  } catch {
-    // dispose is best-effort
-  }
+    if (handle === undefined)
+        return;
+    try {
+        await handle.dispose();
+    }
+    catch {
+        // dispose is best-effort
+    }
 }
-
 /** 审查 prompt：规则引擎发现 + 截断的增量 diff，要求严格 JSON 输出。 */
 function aiReviewPrompt(diffText, report) {
-  const diff = diffText.length > AI_DIFF_MAX ? `${diffText.slice(0, AI_DIFF_MAX)}\n…（diff 过长已截断）` : diffText
-  const rules = report.issues
-    .map((issue) => `- [${issue.severity}] ${issue.rule} ${issue.file}:${issue.line} ${issue.message}`)
-    .join('\n')
-  return `你是一个代码审查员。请审查以下提交前的增量 diff。规则引擎已给出参考问题，请结合 diff 给出总评与最重要的补充问题。
+    const diff = diffText.length > AI_DIFF_MAX ? `${diffText.slice(0, AI_DIFF_MAX)}\n…（diff 过长已截断）` : diffText;
+    const rules = report.issues
+        .map((issue) => `- [${issue.severity}] ${issue.rule} ${issue.file}:${issue.line} ${issue.message}`)
+        .join('\n');
+    return `你是一个代码审查员。请审查以下提交前的增量 diff。规则引擎已给出参考问题，请结合 diff 给出总评与最重要的补充问题。
 
 规则引擎发现：
 ${rules === '' ? '（无）' : rules}
@@ -81,79 +83,82 @@ ${diff}
 请严格只输出一个 JSON 对象（不要输出其他内容）：
 {"verdict": "approve" 或 "changes", "summary": "50 字以内的总评", "topIssues": ["补充问题 1", "补充问题 2"]}
 
-判断标准：存在阻塞性问题（密钥泄露、冲突标记、明显 bug）时 verdict 必须为 changes。`
+判断标准：存在阻塞性问题（密钥泄露、冲突标记、明显 bug）时 verdict 必须为 changes。`;
 }
-
 /** 从 agent 回复提取 JSON 结论（容忍 markdown 代码块包裹）。 */
 function parseAiConclusion(text) {
-  const json = jsonTextOf(text)
-  if (json === undefined) return undefined
-  try {
-    const parsed = JSON.parse(json)
-    if (!isObject(parsed)) return undefined
-    return {
-      verdict: parsed.verdict === 'changes' ? 'changes' : 'approve',
-      summary: stringOf(parsed.summary).slice(0, 500),
-      topIssues: issuesOf(parsed.topIssues),
+    const json = jsonTextOf(text);
+    if (json === undefined)
+        return undefined;
+    try {
+        const parsed = JSON.parse(json);
+        if (!isObject(parsed))
+            return undefined;
+        return {
+            verdict: parsed.verdict === 'changes' ? 'changes' : 'approve',
+            summary: stringOf(parsed.summary).slice(0, 500),
+            topIssues: issuesOf(parsed.topIssues),
+        };
+    }
+    catch {
+        return undefined;
     }
-  } catch {
-    return undefined
-  }
 }
-
 /** 提取 JSON 文本：裸 JSON 或 ```json 代码块。 */
 function jsonTextOf(text) {
-  if (typeof text !== 'string' || text === '') return undefined
-  const trimmed = text.trim()
-  return trimmed.startsWith('{') ? trimmed : extractJsonBlock(trimmed)
+    if (typeof text !== 'string' || text === '')
+        return undefined;
+    const trimmed = text.trim();
+    return trimmed.startsWith('{') ? trimmed : extractJsonBlock(trimmed);
 }
-
 function isObject(value) {
-  return value !== null && typeof value === 'object'
+    return value !== null && typeof value === 'object';
 }
-
 function stringOf(value) {
-  return typeof value === 'string' ? value : ''
+    return typeof value === 'string' ? value : '';
 }
-
 /** topIssues 规整：字符串数组，上限 10 条。 */
 function issuesOf(raw) {
-  return Array.isArray(raw) ? raw.filter((item) => typeof item === 'string').slice(0, 10) : []
+    return Array.isArray(raw) ? raw.filter((item) => typeof item === 'string').slice(0, 10) : [];
 }
-
 /** 从 ```json ... ``` 代码块提取 JSON 文本。 */
 function extractJsonBlock(text) {
-  const match = /```(?:json)?\s*([\s\S]*?)```/.exec(text)
-  return match !== null ? match[1].trim() : undefined
+    const match = /```(?:json)?\s*([\s\S]*?)```/.exec(text);
+    return match !== null ? match[1].trim() : undefined;
 }
-
 /** 会话事件快照：新 API snapshotEvents() 优先，旧 API events 兜底（issue #165）。 */
 function sessionEvents(session) {
-  return session?.snapshotEvents?.() ?? session?.events
+    const target = session;
+    return target?.snapshotEvents?.() ?? target?.events;
 }
-
 function lastAssistantText(session) {
-  try {
-    const events = sessionEvents(session)
-    if (!Array.isArray(events)) return ''
-    for (let i = events.length - 1; i >= 0; i--) {
-      const text = assistantTextOf(events[i])
-      if (text !== '') return text
+    try {
+        const events = sessionEvents(session);
+        if (!Array.isArray(events))
+            return '';
+        for (let i = events.length - 1; i >= 0; i--) {
+            const text = assistantTextOf(events[i]);
+            if (text !== '')
+                return text;
+        }
     }
-  } catch {
-    // best-effort
-  }
-  return ''
+    catch {
+        // best-effort
+    }
+    return '';
 }
-
 function assistantTextOf(event) {
-  if (event?.type !== 'assistant/message') return ''
-  const blocks = event.data?.message?.content
-  if (!Array.isArray(blocks)) return ''
-  return blocks
-    .filter(
-      (block) => block !== null && typeof block === 'object' && block.type === 'text' && typeof block.text === 'string',
-    )
-    .map((block) => block.text)
-    .join('\n')
+    const target = event;
+    if (target?.type !== 'assistant/message')
+        return '';
+    const blocks = target.data?.message?.content;
+    if (!Array.isArray(blocks))
+        return '';
+    return blocks
+        .filter((block) => block !== null &&
+        typeof block === 'object' &&
+        block.type === 'text' &&
+        typeof block.text === 'string')
+        .map((block) => block.text)
+        .join('\n');
 }