dsh-my-observability 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+本文件记录 dsh-my-observability 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.1.0] - 2026-08-28
+
+### 新增
+
+- **事件审计（issue #53）**：监听 `agent/status`（agent_status，含顶层/子代理标记）、`llm/stream`（llm_stream，同步包装流透传全部 chunk，记录开始/结束/错误 + chunk/字符/耗时统计）、`tools/pre-execute`（tool_call，工具名 + 参数键列表 + 文本摘要截断）、`tools/execute`（tool_result，成功/失败 + 耗时）；waterfall 一律透传 `next()`，只读观察不改变流程。
+- **审计持久化**：`$DSH_HOME/observability/audit.json`（防抖 500ms + 原子写 tmp+rename + teardown flush），启动异步加载（加载前事件缓冲不丢），重启后完整恢复；按会话隔离；每会话 2000 条 / 全局 20000 条上限防膨胀。
+- **轨迹回放面板**：侧边栏页签 `dsh-my-observability:replay`（dsh-better-sidebar 服务），会话选择 + 类型过滤（全部/状态/模型流/工具）+ 时间轴事件列表（徽标 + 时间 + 摘要）；可见时 5s 轮询、隐藏时暂停。
+- **结构化 Git 工具**：侧边栏页签 `dsh-my-observability:git`——仓库状态（分支 + 暂存/未暂存计数）、差异查看（工作区/暂存区）、类型化提交（Conventional Commits：type 枚举 feat/fix/docs/style/refactor/test/chore + 可选 scope/body，服务端生成消息 + execFile 执行 git 不经 shell）。
+- **增量 diff 审查**：`POST /observability/api/review`——unified diff 解析 + 8 条规则引擎（secret-leak/conflict-marker 为 error，debug-statement/large-diff/binary-file 为 warning，todo-marker/trailing-space/no-test-change 为 info）；可选 AI 审查增强（agents.create，超时/失败/解析失败降级，规则结果不受影响）。
+- **查询接口**：`GET /observability/api/events`（会话事件，type 过滤 + limit）、`GET /observability/api/sessions`（会话列表）、`GET /observability/api/status`（审计统计 + 开关）；全部经 loopback 信任围栏。
+- **测试**：`test/host-audit.mjs`（事件监听/会话隔离/重启恢复/上限/fence）、`test/host-git.mjs`（真实临时 git 仓库 status/diff/commit）、`test/host-review.mjs`（规则引擎 + AI 各路径）、`test/host-mutation.mjs`（变异补充）、Gherkin 验收（observability/git/review 3 个 feature 16 场景）；覆盖率 行 95% / 分支 85%；变异测试 ≥70%。
+
+**真实环境验证**（独立端口 3081 隔离实例）：
+- 侧边栏「轨迹回放」页签出现，时间轴展示真实 agent 行为（状态/模型流/工具调用）；
+- 「Git 工具」页签：真实仓库状态/差异/类型化提交/提交前审查全流程可用；
+- 重启验证实例后审计事件恢复。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bsfeng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# dsh-my-observability
+
+[![插件生态](https://img.shields.io/badge/插件生态-topic%20dsh-4d6bfe)](https://github.com/topics/dsh)
+
+<div align="center">
+  <img alt="轨迹回放面板：侧边栏时间轴展示 agent 行为（状态/模型流/工具调用）" src="https://unpkg.com/dsh-my-observability/assets/replay-panel.png" width="640" />
+  <img alt="Git 工具面板：仓库状态 / 差异 / 提交前审查 / 类型化提交" src="https://unpkg.com/dsh-my-observability/assets/git-panel.png" width="640" />
+</div>
+
+**DSH 可观测性 + Git 工程工具插件**：**事件审计**记录 agent 的每一次行为（状态变化 / 模型流 / 工具调用与结果），**轨迹回放面板**在侧边栏按时间轴回放会话轨迹；**结构化 Git 工具**提供 Conventional Commits 类型化提交；**增量 diff 审查**在提交前用规则引擎（可选 AI 增强）检查调试残留、密钥泄露等问题。
+
+## 功能
+
+### 1. 事件审计（agent 行为可追溯）
+
+Server 端只读观察 DSH 生命周期事件并记录审计日志：
+
+| 事件 | 审计记录 | 说明 |
+|------|---------|------|
+| `agent/status` | `agent_status` | 状态变化 + 顶层/子代理标记 |
+| `llm/stream` | `llm_stream` | 流开始/结束/错误 + chunk/字符/耗时统计（同步包装流，透传全部 chunk） |
+| `tools/pre-execute` | `tool_call` | 工具名 + 参数键列表 + 主要文本参数截断摘要 |
+| `tools/execute` | `tool_result` | 工具名 + 成功/失败 + 耗时 |
+
+- **会话隔离**：事件按会话分桶，切换会话互不串扰；
+- **重启恢复**：持久化到 `$DSH_HOME/observability/audit.json`（防抖 + 原子写），重启后完整恢复；
+- **防膨胀**：每会话最多 2000 条（FIFO 淘汰）、全局 20000 条（轮转淘汰）；
+- **只读观察**：waterfall 事件一律透传 `next()`，绝不改变工具/模型流程。
+
+### 2. 轨迹回放面板（时间轴）
+
+侧边栏「轨迹回放」页签：选择会话 + 类型过滤（全部 / 状态 / 模型流 / 工具），按时间轴展示 agent 行为（类型徽标 + 时间 + 摘要）；面板可见时 5s 轮询、隐藏时暂停。
+
+### 3. 结构化 Git 工具（类型化提交）
+
+侧边栏「Git 工具」页签：输入仓库路径 → 查看状态（分支 + 暂存/未暂存计数）与差异（工作区/暂存区）→ **类型化提交**：
+
+- 类型枚举：`feat` / `fix` / `docs` / `style` / `refactor` / `test` / `chore`；
+- 消息格式：`<type>(<scope>): <description>`（scope 可选，body 可选）；
+- 服务端生成消息 + `execFile` 执行 git（不经 shell），提交历史清晰可追溯。
+
+### 4. 增量 diff 审查（提交前审查）
+
+「提交前审查」按钮对增量 diff 运行规则引擎（确定性、可测试）：
+
+| 规则 | 严重级别 | 检查内容 |
+|------|---------|---------|
+| `secret-leak` | error | 密钥/凭据硬编码（password/api_key/secret/token） |
+| `conflict-marker` | error | 合并冲突标记残留（`<<<<<<<` / `=======` / `>>>>>>>`） |
+| `debug-statement` | warning | 调试残留（console.* / debugger / print 族） |
+| `large-diff` | warning | 单文件变更 > 300 行 |
+| `binary-file` | warning | 二进制文件变更 |
+| `todo-marker` | info | TODO/FIXME/HACK 标记 |
+| `trailing-space` | info | 行尾多余空格 |
+| `no-test-change` | info | 有源码变更但无测试变更 |
+
+- **可选 AI 审查**：配置 `aiReview`（默认开）且 agents 服务可用时，创建独立审查 agent 阅读 diff 输出总评（verdict/summary/topIssues）；超时/失败/解析失败自动降级，规则引擎结果不受影响（AI 是增强，不是门禁）。
+
+## 工作原理
+
+- **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 卸载无残留。
+
+## 安装
+
+> 💡 **npm 安装（普通用户推荐）**：`dsh plugin --profile web add dsh-my-observability`——无需克隆本仓库；以下 link 方式供本仓库开发者使用。
+
+```bash
+# 1) 克隆本仓库（任意目录）
+git clone https://github.com/baosfeng/my-dsh-plugins.git
+# 2) 以本地 link 方式安装（将 <仓库路径> 替换为上面的克隆目录）
+dsh plugin --profile web add link:<仓库路径>/plugins/dsh-my-observability
+```
+
+- server 端改动需重启 `dsh web`；client 端改动浏览器硬刷新（Cmd/Ctrl+Shift+R）即可。
+
+## 配置
+
+插件级配置（`cordis.patch.yml` 对应插件行的 `config` 字段，均为可选）：
+
+```yaml
+- insert:
+    - id: observability
+      name: 'dsh-my-observability'
+    - config:            # 传给 apply(ctx, config)
+        aiReview: true   # 增量 diff 审查启用 AI 增强（默认 true；agents 服务不可用时自动降级）
+        aiTimeoutMs: 60000  # AI 审查超时（毫秒，默认 60000）
+```
+
+## 依赖
+
+| 依赖 | 用途 | 可选 |
+|------|------|------|
+| `cordis` | 插件运行时 | 是（宿主提供） |
+| `react` | client 端组件 | 是（宿主提供） |
+
+## 限制与说明
+
+- **Git 工具作用于本机仓库**：仓库路径由你在面板中输入（localStorage 记住），仅本机可访问（loopback 围栏）。
+- **AI 审查需要 agents 服务**：不可用时审查自动降级为纯规则引擎结果，不影响使用。
+- **审计上限**：每会话 2000 条 / 全局 20000 条，超出自动淘汰最旧事件。
+
+## 相关文档
+
+→ [可观测性模块文档](../../docs/可观测性/概述.md) · [需求清单](../../docs/可观测性/需求清单.md) · [CHANGELOG](CHANGELOG.md)

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# dsh-my-observability bundle patch: inserts the plugin row into the profile roster.
+# The row mounts the host half (agent event audit + trajectory store + git
+# tooling + diff review) and the client half (sidebar replay timeline + git
+# panel). Install with:
+#
+#   git clone https://github.com/baosfeng/my-dsh-plugins.git
+#   dsh plugin --profile web add link:<仓库路径>/plugins/dsh-my-observability
+- insert:
+    - id: observability
+      name: 'dsh-my-observability'

package/lib/ai.js

@@ -0,0 +1,165 @@
+/**
+ * dsh-my-observability — AI-augmented diff review (optional).
+ *
+ * 规则引擎（lib/review.js）给出确定性结果后，若 agents 服务可用且配置
+ * 开启 aiReview，创建独立审查 agent 阅读增量 diff 并输出 JSON 结论：
+ *  - 成功：报告追加 { enabled, verdict, summary, topIssues }
+ *  - 超时 / agents 不可用 / 结论解析失败：降级 { enabled, failed, note }，
+ *    规则引擎结果不受影响（AI 是增强，不是门禁）
+ *
+ * 参考 dsh-task-reliability 的校验 agent 模式（agents.create + whenIdle
+ * 超时 + dispose）。
+ */
+import { REVIEW_TIMEOUT_MS } from './constants.js'
+
+/** diff 送入 prompt 的最大长度（截断防 token 爆炸）。 */
+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' }
+  const sessionId = `obs-review-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
+  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)
+  }
+}
+
+/** 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
+}
+
+/** 释放审查 agent（尽力而为）。 */
+async function disposeHandle(handle) {
+  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 给出总评与最重要的补充问题。
+
+规则引擎发现：
+${rules === '' ? '（无）' : rules}
+
+增量 diff：
+${diff}
+
+请严格只输出一个 JSON 对象（不要输出其他内容）：
+{"verdict": "approve" 或 "changes", "summary": "50 字以内的总评", "topIssues": ["补充问题 1", "补充问题 2"]}
+
+判断标准：存在阻塞性问题（密钥泄露、冲突标记、明显 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),
+    }
+  } 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)
+}
+
+function isObject(value) {
+  return value !== null && typeof value === 'object'
+}
+
+function stringOf(value) {
+  return typeof value === 'string' ? value : ''
+}
+
+/** topIssues 规整：字符串数组，上限 10 条。 */
+function issuesOf(raw) {
+  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
+}
+
+// ── helpers（与 dsh-task-reliability 同契约的轻量实现）────────────────────
+
+function withTimeout(promise, ms) {
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(undefined), ms)
+    Promise.resolve(promise).then(
+      (value) => { clearTimeout(timer); resolve(value) },
+      () => { clearTimeout(timer); resolve(undefined) },
+    )
+  })
+}
+
+function userMessage(text) {
+  return {
+    id: `msg-${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`,
+    role: 'user',
+    content: [{ type: 'text', text }],
+    source: { kind: 'user' },
+  }
+}
+
+function lastAssistantText(session) {
+  try {
+    const events = session?.events
+    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 ''
+}
+
+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')
+}

package/lib/audit.js

@@ -0,0 +1,150 @@
+/**
+ * dsh-my-observability — agent event audit listeners.
+ *
+ * 只读观察 DSH 生命周期事件并记录审计日志（agent 行为可追溯）：
+ *  - `agent/status`        → `agent_status`（状态变化，含顶层/子代理标记）
+ *  - `llm/stream`          → `llm_stream`（流开始/结束/错误 + chunk/字符统计；
+ *                            waterfall，包装流透传全部 chunk）
+ *  - `tools/pre-execute`   → `tool_call`（工具调用开始 + 参数摘要；透传 next）
+ *  - `tools/execute`       → `tool_result`（工具结果 ok/失败 + 耗时；透传 next）
+ *
+ * ⚠️ llm/stream 监听器必须保持同步函数：cordis waterfall 不 await listener
+ * 返回值，next() 同步返回流；async listener 会让消费方（vision-toolkit 等
+ * yield* 委托）拿到 Promise 而崩溃。tools/* 同理必须调用 next()。
+ */
+import { MAX_ARG_KEYS, MAX_TEXT_LEN } from './constants.js'
+
+/** 注册全部审计监听；返回 disposer 数组（全部经 ctx.on 注册）。 */
+export function attachAuditListeners(ctx, record) {
+  return [
+    ctx.on('agent/status', (payload) => handleStatus(payload, record)),
+    ctx.on('llm/stream', (options, next) => handleStream(options, next, record)),
+    ctx.on('tools/pre-execute', (exec, next) => handlePreExecute(exec, next, record)),
+    ctx.on('tools/execute', (exec, next) => handleExecute(exec, next, record)),
+  ]
+}
+
+/** agent/status → agent_status 事件（含顶层/子代理标记）。 */
+function handleStatus(payload, record) {
+  const agent = payload?.agent
+  if (agent === null || typeof agent !== 'object') return
+  record({
+    type: 'agent_status',
+    sessionId: typeof agent.id === 'string' ? agent.id : '',
+    data: { status: String(payload?.status ?? ''), agentType: agentTypeOf(agent) },
+  })
+}
+
+/** llm/stream → 包装流（同步返回；无 sessionId 时原样透传）。 */
+function handleStream(options, next, record) {
+  const sessionId = typeof options?.sessionId === 'string' ? options.sessionId : ''
+  if (sessionId === '') return next()
+  const stream = next()
+  return wrapStream(sessionId, stream, record)
+}
+
+/** tools/pre-execute → tool_call 事件（透传 next）。 */
+async function handlePreExecute(exec, next, record) {
+  if (exec !== null && typeof exec === 'object' && typeof exec.agent?.id === 'string') {
+    record({
+      type: 'tool_call',
+      sessionId: exec.agent.id,
+      data: { name: String(exec.name ?? ''), args: summarizeArguments(exec.arguments) },
+    })
+  }
+  return next()
+}
+
+/** tools/execute → tool_result 事件（透传 next 结果）。 */
+async function handleExecute(exec, next, record) {
+  const sessionId = exec?.agent?.id
+  const name = exec?.name
+  if (typeof sessionId !== 'string' || sessionId === '') return next()
+  const startedAt = Date.now()
+  const result = await next()
+  record({
+    type: 'tool_result',
+    sessionId,
+    data: {
+      name: String(name ?? ''),
+      ok: isToolOk(result),
+      ms: Date.now() - startedAt,
+    },
+  })
+  return result
+}
+
+/** 顶层/子代理标记（白名单化：任何子代理标记命中即 subagent）。 */
+function agentTypeOf(agent) {
+  const header = agent.session?.header
+  if (header === undefined || header === null) return 'unknown'
+  if (header.origin === 'subagent') return 'subagent'
+  if (typeof header.delegationDepth === 'number' && header.delegationDepth > 0) return 'subagent'
+  return typeof agent.options?.subagentDepth === 'number' && agent.options.subagentDepth > 0
+    ? 'subagent'
+    : 'top'
+}
+
+/** 工具结果 ok 判定：非对象视为成功；error 字段非空视为失败。 */
+function isToolOk(result) {
+  if (result === null || typeof result !== 'object') return true
+  const error = result.error
+  if (error === undefined || error === null) return true
+  return typeof error === 'object' && Object.keys(error).length === 0
+}
+
+/** 参数摘要：键列表（上限）+ 主要文本参数摘要（上限），防审计膨胀。 */
+function summarizeArguments(args) {
+  if (args === null || typeof args !== 'object') return { keys: [] }
+  const keys = Object.keys(args).slice(0, MAX_ARG_KEYS)
+  const summary = textSummaryOf(args)
+  return summary === '' ? { keys } : { keys, summary }
+}
+
+/** 主要文本参数（command/message/content/question 等）的截断摘要。 */
+function textSummaryOf(args) {
+  for (const key of ['command', 'message', 'content', 'question', 'description', 'prompt']) {
+    const value = args[key]
+    if (typeof value === 'string' && value !== '') return truncate(value)
+  }
+  return ''
+}
+
+/** 截断长文本（保留首段，去换行）。 */
+function truncate(text) {
+  const oneLine = text.split('\n')[0].trim()
+  return oneLine.length > MAX_TEXT_LEN ? `${oneLine.slice(0, MAX_TEXT_LEN)}…` : oneLine
+}
+
+/** 包装 llm 流：透传全部 chunk，记录开始/结束/错误统计。 */
+function wrapStream(sessionId, stream, record) {
+  let chunks = 0
+  let chars = 0
+  const startedAt = Date.now()
+  record({ type: 'llm_stream', sessionId, data: { phase: 'start' } })
+  return (async function* () {
+    try {
+      for await (const chunk of stream) {
+        chunks += 1
+        if (chunk !== null && typeof chunk === 'object' && typeof chunk.text === 'string') {
+          chars += chunk.text.length
+        }
+        yield chunk
+      }
+      record({ type: 'llm_stream', sessionId, data: streamSummary('end', startedAt, chunks, chars) })
+    } catch (error) {
+      record({ type: 'llm_stream', sessionId, data: streamSummary('error', startedAt, chunks, chars, error) })
+      throw error
+    }
+  })()
+}
+
+/** 流结束/错误统计（错误消息截断）。 */
+function streamSummary(phase, startedAt, chunks, chars, error) {
+  const summary = { phase, chunks, chars, ms: Date.now() - startedAt }
+  if (error !== undefined) {
+    const message = error instanceof Error ? error.message : String(error)
+    summary.message = message.length > MAX_TEXT_LEN ? `${message.slice(0, MAX_TEXT_LEN)}…` : message
+  }
+  return summary
+}