@devflow-tools/cli 0.3.1 → 0.4.0

package/dist/lib/plugin-setup.js

@@ -0,0 +1,141 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, readdirSync, statSync, rmSync, } from "node:fs";
+import { join, dirname } from "node:path";
+const PLUGIN_KEY = "@devflow-tools/claude-code-plugin@devflow-local";
+const MARKETPLACE = "devflow-local";
+const PLUGIN_NAME = "@devflow-tools/claude-code-plugin";
+/**
+ * Locate plugin files directory.
+ * Priority: bundled dist/plugin-files (npm) -> monorepo plugins/claude-code (dev)
+ */
+export function getPluginFilesDir() {
+    // npm user: files are at dist/plugin-files relative to compiled JS
+    const bundled = join(dirname(new URL(import.meta.url).pathname), "../../plugin-files");
+    if (existsSync(bundled))
+        return bundled;
+    // monorepo dev: files are at plugins/claude-code relative to repo root
+    const monorepo = join(dirname(new URL(import.meta.url).pathname), "../../../../plugins/claude-code");
+    if (existsSync(monorepo))
+        return monorepo;
+    throw new Error("Plugin files not found. Run `npm run build` first.");
+}
+/**
+ * Ensure the devflow plugin is enabled in ~/.claude/settings.json.
+ * Idempotent: skips if already present.
+ */
+export function ensurePluginEnabled(settingsPath) {
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        }
+        catch {
+            console.warn("Warning: Could not parse settings.json, skipping plugin enablement");
+            return;
+        }
+    }
+    else {
+        mkdirSync(dirname(settingsPath), { recursive: true });
+    }
+    const enabledPlugins = settings.enabledPlugins ?? {};
+    if (enabledPlugins[PLUGIN_KEY] === true)
+        return;
+    enabledPlugins[PLUGIN_KEY] = true;
+    settings.enabledPlugins = enabledPlugins;
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+}
+/**
+ * Write .claude/mcp.json for the project.
+ * Merges with existing config; does not overwrite user's custom servers.
+ * Skips if devflow server already configured.
+ */
+export function writeMcpConfig(projectRoot, mcpCommand) {
+    const claudeDir = join(projectRoot, ".claude");
+    const mcpPath = join(claudeDir, "mcp.json");
+    let existing = {};
+    if (existsSync(mcpPath)) {
+        try {
+            existing = JSON.parse(readFileSync(mcpPath, "utf-8"));
+        }
+        catch {
+            console.warn("Warning: Could not parse existing mcp.json, skipping MCP config");
+            return;
+        }
+    }
+    else {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+    const mcpServers = existing.mcpServers ?? {};
+    if (mcpServers.devflow)
+        return; // already configured, don't overwrite
+    mcpServers.devflow = { command: mcpCommand, args: [], env: {} };
+    existing.mcpServers = mcpServers;
+    writeFileSync(mcpPath, JSON.stringify(existing, null, 2));
+}
+/**
+ * Deploy plugin files to cache directory.
+ * Copies hooks, hooks.json, CLAUDE.md, package.json, dist/ to cache.
+ * Also copies dist/skills/ to ~/.claude/skills/ (Claude Code's actual skill load location).
+ */
+export function deployPlugin(pluginFilesDir, cacheBaseDir, version, globalSkillsDir) {
+    const target = join(cacheBaseDir, MARKETPLACE, PLUGIN_NAME, version);
+    mkdirSync(target, { recursive: true });
+    // Copy hooks/
+    const hooksSrc = join(pluginFilesDir, "hooks");
+    if (existsSync(hooksSrc)) {
+        copyDirSync(hooksSrc, join(target, "hooks"));
+    }
+    // Copy static files
+    for (const file of ["hooks.json", "CLAUDE.md", "package.json"]) {
+        const src = join(pluginFilesDir, file);
+        if (existsSync(src))
+            cpSync(src, join(target, file), { force: true });
+    }
+    // Copy .claude-plugin/plugin.json
+    const pluginJsonSrc = join(pluginFilesDir, ".claude-plugin", "plugin.json");
+    if (existsSync(pluginJsonSrc)) {
+        mkdirSync(join(target, ".claude-plugin"), { recursive: true });
+        cpSync(pluginJsonSrc, join(target, ".claude-plugin", "plugin.json"), { force: true });
+    }
+    // Copy dist/ (command-registry.json + skills/)
+    const distSrc = join(pluginFilesDir, "dist");
+    if (existsSync(distSrc)) {
+        copyDirSync(distSrc, join(target, "dist"));
+    }
+    // Copy injected skills to ~/.claude/skills/
+    if (globalSkillsDir) {
+        const skillsSrc = join(pluginFilesDir, "dist", "skills");
+        if (existsSync(skillsSrc)) {
+            copyDirSync(skillsSrc, globalSkillsDir);
+        }
+    }
+    // Clean old versions
+    cleanOldVersions(target);
+}
+function copyDirSync(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        const srcPath = join(src, entry);
+        const destPath = join(dest, entry);
+        if (statSync(srcPath).isDirectory()) {
+            copyDirSync(srcPath, destPath);
+        }
+        else {
+            cpSync(srcPath, destPath, { force: true });
+        }
+    }
+}
+function cleanOldVersions(currentTarget) {
+    const parentDir = join(currentTarget, "..");
+    if (!existsSync(parentDir))
+        return;
+    const currentVersion = currentTarget.split("/").pop() ?? "";
+    for (const entry of readdirSync(parentDir)) {
+        if (entry !== currentVersion) {
+            const entryPath = join(parentDir, entry);
+            if (statSync(entryPath).isDirectory()) {
+                rmSync(entryPath, { recursive: true, force: true });
+            }
+        }
+    }
+}
+//# sourceMappingURL=plugin-setup.js.map

package/dist/lib/plugin-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-setup.js","sourceRoot":"","sources":["../../src/lib/plugin-setup.ts"],"names":[],"mappings":"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"}

package/dist/plugin-files/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "@devflow-tools/claude-code-plugin",
+  "description": "DevFlow — Developer Intelligence Platform: project context, code graph, knowledge base, memory engine, and workflow automation with 14 domain plugins",
+  "version": "0.3.2",
+  "author": {
+    "name": "DevFlow"
+  },
+  "homepage": "https://github.com/shilongfeicool/dev-flow",
+  "repository": "https://github.com/shilongfeicool/dev-flow",
+  "license": "MIT",
+  "keywords": [
+    "devflow",
+    "context",
+    "knowledge-base",
+    "code-graph",
+    "memory",
+    "workflow",
+    "development"
+  ]
+}

package/dist/plugin-files/CLAUDE.md

@@ -0,0 +1,34 @@
+# DevFlow Plugin for Claude Code
+
+This plugin provides the DevFlow developer intelligence platform inside Claude Code.
+
+## What You Get
+
+- **Context Engine** — Search code by natural language query. Use `/devflow:context` before making any code change.
+- **Graph Engine** — View architecture layers, file groups, and dependency graphs. Use `/devflow:graph` to understand module structure.
+- **Memory Engine** — Access project conventions, tech stack, and past decisions. Use `/devflow:memory` at the start of every task.
+- **Knowledge Engine** — Search official docs for React, Vue, NestJS, TypeScript, and more. Use `/devflow:knowledge` when unsure about API usage.
+- **Workflow Engine** — Run standardized development workflows (bug fixes, features, reviews). Use `/devflow:workflow` for complex multi-step tasks.
+- **Domain Plugins** — Specialized expertise for 14 frameworks/tools via `/devflow:react`, `/devflow:git`, `/devflow:nextjs`, etc.
+
+## How to Use
+
+1. **Before any code change:** `/devflow:context` to understand the current implementation
+2. **Before writing new code:** `/devflow:memory` to check conventions
+3. **When stuck on API:** `/devflow:knowledge` to search docs
+4. **When debugging:** `/devflow:graph` to trace dependencies
+5. **For complex workflows:** `/devflow:workflow` or domain-specific commands like `/devflow:react`
+
+## Architecture
+
+This plugin is a thin skill layer. The real work happens in:
+- `devflow-mcp` — MCP stdio server (auto-started by this plugin)
+- `devflow` CLI — Command-line interface for direct usage
+
+## Project Setup
+
+If DevFlow hasn't been initialized in the current project yet, run:
+```
+devflow init
+devflow index
+```

package/dist/plugin-files/dist/command-registry.json

@@ -0,0 +1,235 @@
+{
+  "version": 1,
+  "commands": {
+    "devflow:context": {
+      "mcpTools": [
+        "get_project_context",
+        "search_symbol"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graph": {
+      "mcpTools": [
+        "get_dependency_graph"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:knowledge": {
+      "mcpTools": [
+        "get_knowledge"
+      ],
+      "blockedNative": [
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:memory": {
+      "mcpTools": [
+        "get_memory"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:workflow": {
+      "mcpTools": [
+        "run_workflow"
+      ],
+      "blockedNative": []
+    },
+    "devflow:react": {
+      "mcpTools": [
+        "react_diagnose_bug",
+        "react_new_feature",
+        "react_audit_performance",
+        "react_review_hooks",
+        "react_refactor_component",
+        "react_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:vue": {
+      "mcpTools": [
+        "vue_diagnose_bug",
+        "vue_new_component",
+        "vue_debug_reactivity"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:tailwind": {
+      "mcpTools": [
+        "tailwind_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:taro": {
+      "mcpTools": [
+        "taro_new_page"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nest": {
+      "mcpTools": [
+        "nest_new_module",
+        "nest_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graphql": {
+      "mcpTools": [
+        "graphql_new_graphql_type",
+        "graphql_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:docker": {
+      "mcpTools": [
+        "docker_dockerize_project"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:performance": {
+      "mcpTools": [
+        "performance_audit_performance"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nextjs": {
+      "mcpTools": [
+        "nextjs_new_page",
+        "nextjs_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:electron": {
+      "mcpTools": [
+        "electron_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    }
+  }
+}

package/dist/plugin-files/dist/skills/devflow:context/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: devflow:context
+description: 检索项目上下文 — 自然语言查询相关代码、符号、依赖关系
+---
+
+<HARD-GATE>
+收到 devflow:context 时，必须先调用以下 MCP 工具之一：
+get_project_context / search_symbol
+</HARD-GATE>
+
+
+
+# /devflow:context
+
+## 执行
+
+1. 如果用户的查询包含中文，先将其中的中文关键词翻译为英文代码术语（空格分隔）
+2. 调用 `get_project_context` MCP 工具：
+
+```
+query = 用户的原始查询内容（包含中文）
+expandedTerms = 你翻译的英文关键词（如 "code review audit module"）
+mode = "fast"  (首次调用；如需更深入结果，再改用 "deep")
+```
+
+示例：
+- 用户查询 "代码审核模块的流程" → expandedTerms = "code review audit module workflow pipeline process"
+- 用户查询 "用户登录认证逻辑" → expandedTerms = "user login authentication auth logic service handler"
+- 用户查询 "数据库缓存策略" → expandedTerms = "database db cache memo redis storage strategy"

package/dist/plugin-files/dist/skills/devflow:docker/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: devflow:docker
+description: Docker 专家 — 镜像优化、Compose 编排、安全扫描、多阶段构建
+---
+
+<HARD-GATE>
+收到 devflow:docker 时，必须先调用以下 MCP 工具之一：
+docker_dockerize_project
+</HARD-GATE>
+
+
+
+# 🐳 DOCKER
+
+你是一个 Docker 专家。使用多阶段构建优化镜像，遵循安全和性能最佳实践。遇到问题先查官方文档。
+
+## 适用场景
+
+**项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证**
+
+**镜像优化：体积分析 → 层优化 → 多阶段重构**
+
+**安全扫描：漏洞检测 → 配置审查 → 修复建议**
+
+**多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理**
+
+## 核心规则
+
+- 使用多阶段构建减小镜像体积
+- 基础镜像固定版本标签（不使用 latest）
+- 利用层缓存优化构建顺序
+- 使用非 root 用户运行应用
+- 使用 .dockerignore 排除无用文件
+- 添加 HEALTHCHECK 监控容器健康状态
+- 不在镜像层中写入敏感信息
+- 修复安全问题时先查 Docker 官方文档确认方案
+
+## 当前版本
+
+- docker-docs: 26.0.0 — https://docs.docker.com/reference/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证 | 调用 MCP 工具 `docker_dockerize_project` |
+| 镜像优化：体积分析 → 层优化 → 多阶段重构 | 调用 MCP 工具 `docker_optimize:image` |
+| 安全扫描：漏洞检测 → 配置审查 → 修复建议 | 调用 MCP 工具 `docker_scan:security` |
+| 多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理 | 调用 MCP 工具 `docker_setup:compose` |

package/dist/plugin-files/dist/skills/devflow:electron/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: devflow:electron
+description: Electron 专家 — IPC 通信、窗口管理、原生模块、自动更新、安全配置
+---
+
+<HARD-GATE>
+收到 devflow:electron 时，必须先调用以下 MCP 工具之一：
+electron_diagnose_bug
+</HARD-GATE>
+
+
+
+# ⚛️ ELECTRON
+
+你是一个 Electron 专家。使用 contextBridge + IPC 安全通信模式。严格遵循 Electron 安全最佳实践。
+
+## 适用场景
+
+**新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理**
+
+**安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖**
+
+**自动更新配置：electron-updater → 发布渠道 → 更新 UI**
+
+**Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试**
+
+## 核心规则
+
+- 使用 contextBridge + ipcRenderer/ipcMain 通信
+- 必须启用 contextIsolation，禁用 nodeIntegration
+- 主进程负责系统操作，渲染进程只做 UI
+- Preload 脚本只暴露最小必要的安全 API
+- 使用 electron-updater 实现自动更新
+- 启用 sandbox 和 CSP 安全策略
+- 避免使用 remote 模块（已废弃）
+- 构建使用 electron-builder 并配置代码签名
+
+## 当前版本
+
+- electron-docs: 30.0.0 — https://www.electronjs.org/docs/latest/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理 | 调用 MCP 工具 `electron_new:ipc` |
+| 安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖 | 调用 MCP 工具 `electron_audit:security` |
+| 自动更新配置：electron-updater → 发布渠道 → 更新 UI | 调用 MCP 工具 `electron_setup:auto-update` |
+| Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试 | 调用 MCP 工具 `electron_diagnose_bug` |

package/dist/plugin-files/dist/skills/devflow:graph/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: devflow:graph
+description: 查看项目模块图谱 — 架构分层、文件分组、依赖可视化
+---
+
+<HARD-GATE>
+收到 devflow:graph 时，必须先调用以下 MCP 工具之一：
+get_dependency_graph
+</HARD-GATE>
+
+
+
+# /devflow:graph
+
+## 执行
+
+调用 `get_dependency_graph` MCP 工具：
+
+```
+target = "all"   (默认，拉取完整图谱)
+depth = 2        (默认，可调整 1-5)
+```
+
+DevFlow 的依赖图谱是预索引的结构化数据（节点类型、边的方向、架构分层），原生工具无法提供同等质量的架构分析。

package/dist/plugin-files/dist/skills/devflow:graphql/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: devflow:graphql
+description: GraphQL 专家 — Schema 设计、N+1 检测、Resolver 优化、安全审计
+---
+
+<HARD-GATE>
+收到 devflow:graphql 时，必须先调用以下 MCP 工具之一：
+graphql_new_graphql_type / graphql_diagnose_bug
+</HARD-GATE>
+
+
+
+# ◈ GRAPHQL
+
+你是一个 GraphQL 专家。使用 Schema-First 设计，Apollo Server 实现。遇到问题先查文档，不凭空猜测。
+
+## 适用场景
+
+**新建 GraphQL Type + Resolver + DataLoader**
+
+**N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader**
+
+**Schema 设计审查：类型设计 → 分页模式 → 安全风险评估**
+
+**GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复**
+
+## 核心规则
+
+- 使用 Schema-First 设计（SDL）定义类型和操作
+- Resolver 保持简洁，业务逻辑在 Service 层
+- 使用 DataLoader 解决 N+1 查询问题
+- Mutation 命名使用动词（create/update/delete）
+- 使用 Connection 模式实现分页
+- 限制查询深度和复杂度防止滥用
+- 遇到不确定的 Schema 设计时先查 GraphQL 官方规范
+
+## 当前版本
+
+- graphql-docs: 2024 — https://graphql.org/learn/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 GraphQL Type + Resolver + DataLoader | 调用 MCP 工具 `graphql_new_graphql_type` |
+| N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader | 调用 MCP 工具 `graphql_fix:n+1` |
+| Schema 设计审查：类型设计 → 分页模式 → 安全风险评估 | 调用 MCP 工具 `graphql_review:schema` |
+| GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复 | 调用 MCP 工具 `graphql_diagnose_bug` |

package/dist/plugin-files/dist/skills/devflow:knowledge/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: devflow:knowledge
+description: 搜索技术文档知识库 — React、Vue、Nest、TypeScript 等官方文档
+---
+
+<HARD-GATE>
+收到 devflow:knowledge 时，必须先调用以下 MCP 工具之一：
+get_knowledge
+</HARD-GATE>
+
+
+
+# /devflow:knowledge
+
+## 执行
+
+调用 `get_knowledge` MCP 工具：
+
+```
+query = 用户的查询内容
+scope = "all"  (默认；可选 react/vue/nest)
+```
+
+DevFlow 知识库预索引了 React、Vue、NestJS、TypeScript 官方文档（带版本标签和代码示例），比 WebSearch/WebFetch 更快更准。