@ alwaysmeticulous/debug-work 空间

提供调试工作空间管道的共享软件包 恶毒 CLI (中文(简体) )meticulous debug(e) 调查视差 并重放问题.

它会做什么

由于重放diff ID或重放 ID (s),此套件 :

1. 决定上下文 -- 从中获取关于测试运行及其重放 diffs 的元数据 冷酷的API,生产 DebugContext 与所有相关的身份证.

2. 下载调试数据 -- 下载重放数据(日志、时间表、参数、资产),会话 录音,重放diffs,并测试将元数据运行到本地的工作空间目录. 下载 与可配置货币平行运行.

3. 生成工作空间 -- 脚手架结构化目录,其中:

   • 模板 - 说吧 CLAUDE.md 复制到 .claude/ 和克洛德密码一起使用.
   • 衍生分析文件 - 制作大型可重放数据的预计算文物 和可管理性:
     • 被过滤的日志(噪声断层日志)
     • Diff 摘要(压缩截图diff结果)
     • 事件指数(每起事件一行时间摘要)
     • 网络日志( 协议请求日志)
     • VT 进取( 分散的虚拟时间值)
     • 日志索引(每入一行日志摘要)
     • 截图时间背景( 围绕每个截图的事件)
     • Diffs出错(错误只重放一次)和覆盖diffs(头对底JS覆盖)
     • 会议摘要、资产
     • 格式化资产(印刷的JS/CSS)
     • 截图 DOM 快照( 每张截图) <name>.html 从 <name>.metadata.json,在每回放时一起写 screenshots/ 目录)
     • DOM diffs( HEAD 的每个屏幕截图统一 diffs vs BASE 相當印出 HTML,取出) 从神秘的后端写到 dom-diffs/ 作为 .diff 文件,兄弟会 .full.diff 完整文件上下文的文件,以及每页文件 .summary.txt. diffs (英语) 与Meticulus产品中所示的相同。 仅生成于 replay-diff 路径。 )
     • PR diff( 基数和头数之间的源代码变化)
   • 内容 JSON -- 有所有ID、路径、文件大小、截图的机器可读元数据 地图,并重放比较数据.

重叠模板

generateDebugWorkspace 接受可选选项 additionalTemplatesDir 参数。 此文件中的文件 覆盖目录优先于与此软件包捆绑的基底模板. 对于 子目录( 代理, 技能), 基础文件先被复制, 然后覆盖文件 在顶部复制——所以重叠可以添加新的文件或用名称替换特定文件.

用于 met_debug (在内部Meticulous repo)提供特定管理员 模板、技能和自定义 CLAUDE.md 而不伪造基本包.

使用量

此软件包由 @alwaysmeticulous/cli 通过 meticulous debug 命令.

import { runDebugPipeline } from "@alwaysmeticulous/debug-workspace";

await runDebugPipeline({
  client,
  replayDiffId: "some-replay-diff-id",
  screenshot: "screenshot-after-event-00042.png",
  createWorktree: (ctx, workspaceDir) =>
    createProjectWorktree({ debugContext: ctx, workspaceDir }),
  onWorkspaceReady: (workspaceDir, projectRepoDir) =>
    presentWorkspace({ workspaceDir, projectRepoDir }),
});

或使用单个步骤进行更多的控制:

import {
  resolveDebugContext,
  downloadDebugData,
  generateDebugWorkspace,
} from "@alwaysmeticulous/debug-workspace";

const debugContext = await resolveDebugContext({ client, replayDiffId });
await downloadDebugData({ client, debugContext, workspaceDir });
await generateDebugWorkspace({
  client,
  debugContext,
  workspaceDir,
  projectRepoDir,
});

主要出口

• runDebugPipeline --运行全管(解析,下载,生成工作空间).
• resolveDebugContext - 决定a DebugContext 从重放 diff ID 或重放 ID .
• downloadDebugData ——将数据和文物再放入工作空间目录.
• generateDebugWorkspace -- 脚手架从模板生成工作空间目录 所有衍生分析文件.
• DebugContext, (中文(简体) ), ReplayDiffInfo -- 描述已解析调试上下文的类型 .
• DEBUG_DATA_DIRECTORY, (中文(简体) ), getDebugSessionsDir - 路径常数.

金属SDK的一部分

此软件包是 细细的sdk 单相机.