npm - cgraphx - Versions diffs - 1.1.0 → 1.2.0 - Mend

cgraphx 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (81) hide show

package/README.md +0 -1
package/dist/.claude-template/skills/cgraphx/SKILL.md +3 -3
package/dist/.claude-template/skills/cgraphx/agent-prompt.md +1 -1
package/dist/.claude-template/skills/cgraphx-guide/SKILL.md +94 -0
package/dist/.claude-template/skills/cgraphx-guide/how-to-use.html +403 -0
package/dist/.claude-template/skills/clarify-requirements/SKILL.md +19 -8
package/dist/.claude-template/skills/code-impact-docgen/SKILL.md +186 -176
package/dist/.claude-template/skills/code-impact-docgen/template-design-html.md +357 -0
package/dist/.claude-template/skills/code-impact-docgen/template-design-md.md +164 -0
package/dist/.claude-template/skills/code-impact-init/SKILL.md +47 -47
package/dist/.claude-template/skills/developer-timeline/SKILL.md +9 -0
package/dist/.claude-template/skills/write-api-doc/SKILL.md +317 -0
package/dist/.claude-template/skills/write-api-doc/template-api-html.md +422 -0
package/dist/.claude-template/skills/write-plan/SKILL.md +38 -16
package/dist/.claude-template/skills/write-prd/SKILL.md +32 -8
package/dist/.claude-template/skills/write-spec/SKILL.md +34 -9
package/dist/bin/codegraph.js +0 -100
package/dist/bin/codegraph.js.map +1 -1
package/dist/resolution/index.d.ts.map +1 -1
package/dist/resolution/index.js +13 -0
package/dist/resolution/index.js.map +1 -1
package/dist/resolution/scope-index.d.ts +86 -0
package/dist/resolution/scope-index.d.ts.map +1 -0
package/dist/resolution/scope-index.js +143 -0
package/dist/resolution/scope-index.js.map +1 -0
package/dist/resolution/stdlib-blocklist.d.ts +53 -0
package/dist/resolution/stdlib-blocklist.d.ts.map +1 -0
package/dist/resolution/stdlib-blocklist.js +143 -0
package/dist/resolution/stdlib-blocklist.js.map +1 -0
package/dist/search/ast-helpers.d.ts +42 -0
package/dist/search/ast-helpers.d.ts.map +1 -0
package/dist/search/ast-helpers.js +106 -0
package/dist/search/ast-helpers.js.map +1 -0
package/dist/search/call-sites.d.ts +398 -0
package/dist/search/call-sites.d.ts.map +1 -0
package/dist/search/call-sites.js +1433 -0
package/dist/search/call-sites.js.map +1 -0
package/dist/search/context.d.ts +134 -0
package/dist/search/context.d.ts.map +1 -0
package/dist/search/context.js +575 -0
package/dist/search/context.js.map +1 -0
package/dist/search/impact.d.ts +139 -0
package/dist/search/impact.d.ts.map +1 -0
package/dist/search/impact.js +646 -0
package/dist/search/impact.js.map +1 -0
package/dist/search/related.d.ts +178 -0
package/dist/search/related.d.ts.map +1 -0
package/dist/search/related.js +667 -0
package/dist/search/related.js.map +1 -0
package/dist/search/slice.d.ts +148 -0
package/dist/search/slice.d.ts.map +1 -0
package/dist/search/slice.js +460 -0
package/dist/search/slice.js.map +1 -0
package/dist/search/snr-constants.d.ts +41 -0
package/dist/search/snr-constants.d.ts.map +1 -0
package/dist/search/snr-constants.js +44 -0
package/dist/search/snr-constants.js.map +1 -0
package/dist/search/types.d.ts +28 -0
package/dist/search/types.d.ts.map +1 -0
package/dist/search/types.js +12 -0
package/dist/search/types.js.map +1 -0
package/dist/timeline/cli.d.ts.map +1 -1
package/dist/timeline/cli.js +22 -3
package/dist/timeline/cli.js.map +1 -1
package/dist/timeline/store.d.ts +5 -0
package/dist/timeline/store.d.ts.map +1 -1
package/dist/timeline/store.js +23 -3
package/dist/timeline/store.js.map +1 -1
package/package.json +1 -1
package/scripts/agent-eval/block-cgraphx-and-gitnexus-cli-hook.sh +43 -0
package/scripts/agent-eval/block-cgraphx-cli-hook.sh +32 -0
package/scripts/agent-eval/block-cgraphx-cli-settings.json +16 -0
package/scripts/agent-eval/cli-vs-mcp-3arm.sh +121 -0
package/scripts/agent-eval/multi-tool-eval.sh +171 -0
package/scripts/agent-eval/parse-cli-vs-mcp.mjs +232 -0
package/scripts/agent-eval/parse-multi-tool.mjs +242 -0
package/scripts/agent-eval/subagent-token-cost.py +188 -0
package/dist/.claude-template/skills/code-impact-docgen/template-business-html.md +0 -242
package/dist/.claude-template/skills/code-impact-docgen/template-business-md.md +0 -107
package/dist/.claude-template/skills/code-impact-docgen/template-technical-html.md +0 -205
package/dist/.claude-template/skills/code-impact-docgen/template-technical-md.md +0 -155

package/dist/.claude-template/skills/code-impact-docgen/template-business-md.md DELETED Viewed

@@ -1,107 +0,0 @@
-# Business 文档 Markdown 模板
-适用于面向业务读者的 Markdown 格式文档。
-## 文档结构
-```markdown
-# {文档标题}
-> 生成日期：YYYY-MM-DD | 主题范围：{范围描述}
-## 目录
-- [背景与目标](#背景与目标)
-- [核心能力](#核心能力)
-- [业务流程](#业务流程)
-- [关键决策](#关键决策)
-- [现状与展望](#现状与展望)
-## 背景与目标
-说明项目/系统的定位、目标和解决的问题。
-## 核心能力
-描述系统提供的主要能力和价值。
-## 业务流程
-说明核心业务流程和操作步骤。
-## 关键决策
-列出重要的技术和业务决策及其理由。
-## 现状与展望
-说明当前状态和未来方向。
-```
-## 可选章节（按需插入）
-```markdown
-## 用户场景
-描述典型使用场景。
-## 价值与影响
-说明对业务的价值和影响。
-## 风险与注意事项
-列出已知风险和应对措施。
-## 常见问题
-**Q: 问题一？**
-A: 回答。
-**Q: 问题二？**
-A: 回答。
-## 术语表
-| 术语 | 定义 |
-|------|------|
-| 术语 A | 简洁的业务定义 |
-| 术语 B | 简洁的业务定义 |
-## 相关资源
-- [相关文档](相对路径)
-- [外部链接](URL)
-```
-## Business Markdown 章节内容指南
-| 章节 | 内容来源 | 改写方向 |
-|------|------------------------|----------|
-| 背景与目标 | Summary 文本 | 从"为什么分析"转为"项目/系统的目标和定位" |
-| 核心能力 | Summary 文本 | 从"发现"转为"能力描述"，面向非技术读者 |
-| 业务流程 | Read 文件原文（该章节 cgraphx 不提取） | 从"操作步骤"转为"业务流程说明"，去除技术细节 |
-| 关键决策 | Read 文件原文（该章节 cgraphx 不提取） | 从"决策记录"转为"决策解释"，说明决策的业务原因 |
-| 价值与影响 | Read 文件原文（该章节 cgraphx 不提取） | 从"对未来变更的影响"转为"对业务的价值和影响" |
-| 现状与展望 | Read 文件原文（该章节 cgraphx 不提取） | 从"发现和后续"转为"当前状态和未来规划" |
-| 风险与注意事项 | Read 文件原文（该章节 cgraphx 不提取） | 从"故障排除"转为"风险提示和应对措施" |
-| 常见问题 | Read 文件原文（该章节 cgraphx 不提取） | 从"分析记录"转为"Q&A 格式" |
-| 术语表 | 各文本字段中的术语 | 提取关键术语，给出简洁的业务定义 |
-| 相关资源 | — | 列出相关的代码文件（相对路径）或外部文档 |
-## 格式规则
-- 不使用 YAML frontmatter
-- 文档标题使用单个 `#`
-- 章节使用 `##`
-- 子章节使用 `###`
-- 列表使用 `-` 或数字编号
-- 代码块使用三个反引号，标注语言
-- 表格使用标准 Markdown 表格
-- 强调使用 `**加粗**`
-- 技术术语用反引号包裹
-- 段落之间空一行
-- 每个章节以 `##` 标题开始，标题后空一行再写内容
-- 目录使用锚点链接，链接文本与章节标题一致

package/dist/.claude-template/skills/code-impact-docgen/template-technical-html.md DELETED Viewed

@@ -1,205 +0,0 @@
-# Technical 文档 HTML 模板
-适用于面向技术读者的 HTML 格式文档。
-与 Business HTML 模板共享基础 CSS 样式，但增加技术文档专属样式和不同的章节结构。生成前先阅读 [template-business-html.md](template-business-html.md) 获取基础 CSS，在此基础上追加以下额外样式。
-## 追加 CSS
-在 Business HTML 的 `<style>` 基础上追加：
-```css
-.diagram {
-  background: var(--surface);
-  border: 1px solid var(--border);
-  border-radius: 8px;
-  padding: 1.5em;
-  margin-bottom: 1em;
-  font-family: var(--font-mono);
-  font-size: 0.875em;
-  white-space: pre;
-  overflow-x: auto;
-  line-height: 1.5;
-}
-.tag {
-  display: inline-block;
-  font-size: 0.8em;
-  background: var(--accent-light);
-  color: var(--accent);
-  border: 1px solid rgba(0, 113, 227, 0.2);
-  padding: 0.15em 0.6em;
-  border-radius: 12px;
-}
-.api-method {
-  font-family: var(--font-mono);
-  font-weight: 600;
-}
-.decision-block {
-  background: var(--surface);
-  border: 1px solid var(--border);
-  border-radius: 8px;
-  padding: 1em 1.5em;
-  margin-bottom: 1em;
-}
-.decision-block h4 {
-  margin-top: 0;
-  margin-bottom: 0.5em;
-  color: var(--accent);
-}
-.decision-block dl {
-  display: grid;
-  grid-template-columns: auto 1fr;
-  gap: 0.3em 1em;
-  font-size: 0.95em;
-}
-.decision-block dt {
-  font-weight: 600;
-  color: var(--text-secondary);
-}
-.decision-block dd {
-  margin: 0;
-}
-.limit-table td:first-child {
-  white-space: nowrap;
-  font-weight: 600;
-  color: var(--text-secondary);
-}
-```
-## 完整 HTML 结构
-```html
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>{文档标题} — {项目名称}</title>
-  <style>
-    /* 基础样式：复制 template-business-html.md 的完整 CSS */
-    /* 然后追加上述额外 CSS */
-  </style>
-</head>
-<body>
-  <div class="container">
-    <h1>{文档标题}</h1>
-    <p class="meta">生成日期：YYYY-MM-DD | 主题范围：{范围描述}</p>
-    <nav class="toc">
-      <h3>目录</h3>
-      <ul>
-        <li><a href="#概述">概述</a></li>
-        <li><a href="#架构设计">架构设计</a></li>
-        <li><a href="#核心模块">核心模块</a>
-          <ul>
-            <li><a href="#模块A">模块 A</a></li>
-            <li><a href="#模块B">模块 B</a></li>
-          </ul>
-        </li>
-        <li><a href="#技术决策">技术决策</a></li>
-        <li><a href="#已知限制">已知限制</a></li>
-        <li><a href="#扩展方向">扩展方向</a></li>
-      </ul>
-    </nav>
-    <article>
-      <section id="概述">
-        <h2>概述</h2>
-        <p>系统概述和技术定位。</p>
-      </section>
-      <section id="架构设计">
-        <h2>架构设计</h2>
-        <p>系统架构和数据流描述。</p>
-        <pre class="diagram">组件 A ──→ 组件 B ──→ 组件 C
-              │
-              ↕
-           外部服务</pre>
-      </section>
-      <section id="核心模块">
-        <h2>核心模块</h2>
-        <section id="模块A">
-          <h3>模块 A</h3>
-          <p>职责描述和关键接口。</p>
-        </section>
-        <section id="模块B">
-          <h3>模块 B</h3>
-          <p>职责描述和关键接口。</p>
-        </section>
-      </section>
-      <section id="技术决策">
-        <h2>技术决策</h2>
-        <div class="decision-block">
-          <h4>决策标题</h4>
-          <dl>
-            <dt>选择</dt>
-            <dd>xxx</dd>
-            <dt>原因</dt>
-            <dd>xxx</dd>
-            <dt>替代方案</dt>
-            <dd>xxx</dd>
-          </dl>
-        </div>
-      </section>
-      <section id="已知限制">
-        <h2>已知限制</h2>
-        <table class="limit-table">
-          <thead>
-            <tr><th>限制</th><th>影响范围</th><th>应对措施</th></tr>
-          </thead>
-          <tbody>
-            <tr><td>限制描述</td><td>影响范围</td><td>应对措施</td></tr>
-          </tbody>
-        </table>
-      </section>
-      <section id="扩展方向">
-        <h2>扩展方向</h2>
-        <ol>
-          <li><strong>方向 A</strong> — 描述和优先级</li>
-          <li><strong>方向 B</strong> — 描述和优先级</li>
-        </ol>
-      </section>
-    </article>
-  </div>
-</body>
-</html>
-```
-## Technical HTML 章节内容指南
-| 章节 | 内容来源 | 改写方向 |
-|------|------------------------|----------|
-| 概述 | Summary 文本 | 保留技术精确度，增加架构上下文 |
-| 架构设计 | Summary 文本 + Read 文件原文 | 补充系统级架构图（文本框图）、数据流描述 |
-| 核心模块 | Summary 文本 + Read 文件原文 | 按模块分组，说明职责和交互关系 |
-| 数据模型 | Read 文件原文（该章节 cgraphx 不提取） | 用表格展示节点类型、属性、关系 |
-| 技术决策 | Read 文件原文（该章节 cgraphx 不提取） | 保留决策理由，补充替代方案对比 |
-| API 参考 | Read 文件原文（该章节 cgraphx 不提取） | 按 endpoint 分组，包含请求/响应示例 |
-| 性能特征 | Read 文件原文（该章节 cgraphx 不提取） | 用表格展示瓶颈和优化方向 |
-| 已知限制 | Read 文件原文（该章节 cgraphx 不提取） | 按严重程度排序，说明影响范围 |
-| 扩展方向 | Read 文件原文（该章节 cgraphx 不提取） | 按优先级排序，说明实现复杂度 |
-| 运维指南 | Read 文件原文（该章节 cgraphx 不提取） | 按"部署 / 监控 / 排障"分组 |
-## HTML 格式要点
-- 继承 Business HTML 的所有格式要点
-- 架构图使用 `<pre class="diagram">` 包裹 ASCII 文本框图
-- 技术决策使用 `<div class="decision-block">` 结构，包含 `<dl>` 列表
-- 已知限制使用表格，按严重程度降序排列
-- 模块描述使用 `<section id="模块名">` + `<h3>` 子标题
-- API 端点使用 `<span class="api-method">GET</span>` 标注 HTTP 方法
-- 技术标签使用 `<span class="tag">标签名</span>` 样式

package/dist/.claude-template/skills/code-impact-docgen/template-technical-md.md DELETED Viewed

@@ -1,155 +0,0 @@
-# Technical 文档 Markdown 模板
-适用于面向技术读者的 Markdown 格式文档。
-## 文档结构
-```markdown
-# {文档标题}
-> 生成日期：YYYY-MM-DD | 主题范围：{范围描述}
-## 目录
-- [概述](#概述)
-- [架构设计](#架构设计)
-- [核心模块](#核心模块)
-  - [模块 A](#模块-a)
-  - [模块 B](#模块-b)
-- [技术决策](#技术决策)
-- [已知限制](#已知限制)
-- [扩展方向](#扩展方向)
-## 概述
-系统概述和技术定位。
-## 架构设计
-系统架构和数据流描述。
-```
-组件 A ──→ 组件 B ──→ 组件 C
-      │
-      ↕
-   外部服务
-```
-## 核心模块
-### 模块 A
-职责描述、关键接口和依赖关系。
-### 模块 B
-职责描述、关键接口和依赖关系。
-## 技术决策
-### 决策标题
-- **选择**：xxx
-- **原因**：xxx
-- **替代方案**：xxx
-## 已知限制
-| 限制 | 影响范围 | 应对措施 |
-|------|----------|----------|
-| 限制描述 | 影响范围 | 应对措施 |
-## 扩展方向
-1. **方向 A** — 描述和优先级
-2. **方向 B** — 描述和优先级
-```
-## 可选章节（按需插入）
-```markdown
-## 数据模型
-| 类型 | 属性 | 关系 |
-|------|------|------|
-| 节点类型 A | 属性列表 | 关系列表 |
-## API 参考
-### 端点名称
-`POST /api/path`
-**请求参数**：
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| param | string | 说明 |
-**响应示例**：
-```json
-{
-  "key": "value"
-}
-```
-## 性能特征
-| 瓶颈 | 影响 | 优化方向 |
-|------|------|----------|
-| 描述 | 影响范围 | 优化方案 |
-## 运维指南
-### 部署
-部署步骤和注意事项。
-### 监控
-关键指标和告警规则。
-### 故障排除
-按"症状 → 原因 → 修复"格式记录。
-## 术语表
-| 术语 | 定义 |
-|------|------|
-| 术语 A | 技术定义 |
-| 术语 B | 技术定义 |
-## 相关资源
-- [相关代码](相对路径)
-- [外部文档](URL)
-```
-## Technical Markdown 章节内容指南
-| 章节 | 内容来源 | 改写方向 |
-|------|------------------------|----------|
-| 概述 | Summary 文本 | 保留技术精确度，增加架构上下文 |
-| 架构设计 | Summary 文本 + Read 文件原文 | 补充系统级架构图（代码块中的 ASCII 文本框图）、数据流描述 |
-| 核心模块 | Summary 文本 + Read 文件原文 | 按模块分组，说明职责和交互关系 |
-| 数据模型 | Read 文件原文（该章节 cgraphx 不提取） | 用表格展示节点类型、属性、关系 |
-| 技术决策 | Read 文件原文（该章节 cgraphx 不提取） | 保留决策理由，补充替代方案对比，按"选择/原因/替代方案"格式 |
-| API 参考 | Read 文件原文（该章节 cgraphx 不提取） | 按 endpoint 分组，包含请求参数表格和响应示例 |
-| 性能特征 | Read 文件原文（该章节 cgraphx 不提取） | 用表格展示瓶颈和优化方向 |
-| 已知限制 | Read 文件原文（该章节 cgraphx 不提取） | 按严重程度排序，用表格说明影响范围和应对措施 |
-| 扩展方向 | Read 文件原文（该章节 cgraphx 不提取） | 按优先级排序，用编号列表说明实现复杂度 |
-| 运维指南 | Read 文件原文（该章节 cgraphx 不提取） | 按"部署 / 监控 / 故障排除"分子章节 |
-## 格式规则
-- 继承 [template-business-md.md](template-business-md.md) 的所有格式规则
-- 技术文档额外规则：
-  - 架构图使用代码块中的 ASCII 文本框图，不标注语言类型
-  - 技术决策按"选择 / 原因 / 替代方案"列表格式
-  - 代码示例标注语言类型（`rust`、`bash`、`json` 等）
-  - 文件路径使用行内代码包裹：`src/main.rs`
-  - HTTP 方法使用行内代码包裹：`POST /api/search/hybrid`
-  - 模块描述使用 `###` 子标题
-  - 表格优先用于结构化信息（限制、API 参数、性能瓶颈）