@deepstorm/cli 0.1.0

package/dist/config-schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "DeepStorm Configuration Schema",
+  "description": "定义所有合法的 DeepStorm 配置 key 和结构",
+  "type": "object",
+  "properties": {
+    "tide": {
+      "type": "object",
+      "description": "产品侧配置",
+      "properties": {
+        "issueTracker": {
+          "type": "string",
+          "enum": ["jira", "none"],
+          "description": "Issue 跟踪系统"
+        }
+      },
+      "additionalProperties": false
+    },
+    "reef": {
+      "type": "object",
+      "description": "开发侧配置",
+      "properties": {
+        "frontend": {
+          "type": "object",
+          "properties": {
+            "framework": {
+              "type": "string",
+              "enum": ["angular", "none"],
+              "description": "前端框架"
+            },
+            "tsConfig": {
+              "type": "string",
+              "enum": ["strict", "standard", "none"],
+              "description": "TypeScript 配置模式"
+            },
+            "css": {
+              "type": "string",
+              "enum": ["tailwind", "none"],
+              "description": "CSS 方案"
+            },
+            "test": {
+              "type": "string",
+              "enum": ["vitest", "none"],
+              "description": "前端测试框架"
+            }
+          },
+          "additionalProperties": false
+        },
+        "backend": {
+          "type": "object",
+          "properties": {
+            "language": {
+              "type": "string",
+              "enum": ["java", "none"],
+              "description": "后端语言"
+            },
+            "java": {
+              "type": "object",
+              "description": "Java 子维度",
+              "properties": {
+                "framework": {
+                  "type": "string",
+                  "enum": ["spring-boot", "none"],
+                  "description": "Java Web 框架"
+                },
+                "orm": {
+                  "type": "string",
+                  "enum": ["hibernate", "none"],
+                  "description": "ORM 框架"
+                },
+                "dbMigration": {
+                  "type": "string",
+                  "enum": ["liquibase", "none"],
+                  "description": "数据库迁移工具"
+                },
+                "ai": {
+                  "type": "string",
+                  "enum": ["spring-ai", "none"],
+                  "description": "AI 框架"
+                },
+                "test": {
+                  "type": "string",
+                  "enum": ["junit5", "none"],
+                  "description": "单元测试框架"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "sweep": {
+      "type": "object",
+      "description": "测试侧配置",
+      "properties": {
+        "ciProvider": {
+          "type": "string",
+          "enum": ["github-actions", "gitlab-ci", "jenkins", "none"],
+          "description": "CI 提供商"
+        }
+      },
+      "additionalProperties": false
+    },
+    "atoll": {
+      "type": "object",
+      "description": "运维侧配置",
+      "properties": {
+        "deployTarget": {
+          "type": "string",
+          "enum": ["kubernetes", "docker", "serverless", "none"],
+          "description": "部署目标"
+        }
+      },
+      "additionalProperties": false
+    },
+    "mcp": {
+      "type": "object",
+      "description": "MCP 基础设施配置",
+      "properties": {
+        "installedMcpServers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "已安装的 MCP 服务名列表"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/env-examples/context7.env-example

@@ -0,0 +1,19 @@
+# ════════════════════════════════════════════════════════════════
+# Context7 文档参考
+#
+# 用途：实时查询库/框架的官方文档
+#   - React、Next.js、Vue、Angular
+#   - Prisma、Django、Spring Boot
+#   - Tailwind CSS、Express 等
+#
+# 说明：Claude Code 通过 Context7 获取最新的库文档，
+#       确保代码建议基于最新版本，而非过时的训练数据。
+#       不配置也可使用但有 rate limit，配置后可提升限额。
+#
+# 获取步骤：
+#   1. 访问 https://context7.com/dashboard
+#   2. 注册/登录账号
+#   3. 在 Dashboard 中复制 API Key
+#   4. 将 API Key 填入下方（以 ctx7sk_ 开头）
+# ════════════════════════════════════════════════════════════════
+CONTEXT7_API_KEY=ctx7sk_your_context7_key_here

package/dist/env-examples/feishu-wiki.env-example

@@ -0,0 +1,16 @@
+# ════════════════════════════════════════════════════════════════
+# 飞书知识库 MCP 服务器
+#
+# 用途：文档协作与知识库
+#   - 读取飞书文档中的内容
+#   - 搜索知识库文档
+#   - 辅助获取项目文档上下文
+#
+# Token 获取步骤：
+#   1. 打开飞书开放平台 → 进入「开发者后台」
+#   2. 创建企业自建应用 → 获取 App ID 和 App Secret
+#   3. 在「权限管理」中添加「文档-查看/编辑」权限
+#   4. 发布应用后获取 tenant_access_token
+#   5. 将该 token 值填入下方
+# ════════════════════════════════════════════════════════════════
+FEISHU_WEBHOOK_TOKEN=your_feishu_token_here

package/dist/env-examples/figma.env-example

@@ -0,0 +1,16 @@
+# ════════════════════════════════════════════════════════════════
+# Figma MCP 服务器
+#
+# 用途：原型设计与协作
+#   - 读取 Figma 设计稿中的组件、布局、样式
+#   - 获取设计稿的节点信息和元数据
+#   - 辅助前端开发还原设计稿
+#
+# Token 获取步骤：
+#   1. 打开 Figma → 点击右上角头像 → Settings
+#   2. 左侧导航选择「Personal Access Tokens」
+#   3. 点击「Generate new token」
+#   4. 输入 Token 名称（如 "deepstorm-cli"）
+#   5. 生成后将 token 值填入下方（以 figd_ 开头）
+# ════════════════════════════════════════════════════════════════
+FIGMA_API_KEY=figd_your_figma_token_here

package/dist/env-examples/github.env-example

@@ -0,0 +1,20 @@
+# ════════════════════════════════════════════════════════════════
+# GitHub MCP 服务器
+#
+# 用途：源码托管与协作
+#   - 读取仓库文件、Issue、PR
+#   - 创建和合并 Pull Request
+#   - 管理 Issue、标签、里程碑
+#
+# Token 获取步骤：
+#   1. 访问 https://github.com/settings/tokens
+#   2. 点击「Generate new token (classic)」
+#   3. 选择以下权限（scopes）：
+#      - repo（全部选中，私有仓库需要）
+#      - workflow（如有 GitHub Actions 操作需求）
+#   4. 生成后将 token 值填入下方
+#
+# Docker 要求：GitHub MCP 需要本地 Docker 环境
+#   安装：https://docs.docker.com/get-docker/
+# ════════════════════════════════════════════════════════════════
+GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_github_token_here

package/dist/env-examples/jira.env-example

@@ -0,0 +1,20 @@
+# ════════════════════════════════════════════════════════════════
+# Jira MCP 服务器
+#
+# 用途：任务跟踪与敏捷管理
+#   - 读取 Issue 详情和评论
+#   - 执行 JQL 查询定位 Issue
+#   - 创建和更新 Issue
+#
+# 所需信息：
+#   1. Jira 实例地址
+#      你的域名.atlassian.net
+#   2. 邮箱
+#      登录 Jira 时使用的邮箱地址
+#   3. API Token
+#      生成地址：https://id.atlassian.com/manage-profile/security/api-tokens
+#      点击「Create API token」→ 命名后复制 token
+# ════════════════════════════════════════════════════════════════
+JIRA_INSTANCE_URL=https://your-domain.atlassian.net
+JIRA_USER_EMAIL=your-email@example.com
+JIRA_API_KEY=your_jira_api_token_here

package/dist/hooks/mcp-hook.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# MCP Hook for Claude Code — auto-start Playwright MCP on session start
+# Usage:
+#   ./scripts/mcp-hook.sh              # start in headless mode (default)
+#   ./scripts/mcp-hook.sh --headed     # start with visible browser
+#   ./scripts/mcp-hook.sh --stop       # stop MCP
+#   ./scripts/mcp-hook.sh --status     # check status
+
+MCP_PORT=54321
+BIN="node_modules/.bin/playwright-mcp"
+
+case "${1:-}" in
+  --stop)
+    PID=$(lsof -ti tcp:$MCP_PORT 2>/dev/null)
+    if [ -n "$PID" ]; then
+      kill -9 "$PID" 2>/dev/null
+      echo "mcp: stopped (PID $PID)"
+    else
+      echo "mcp: not running"
+    fi
+    exit 0
+    ;;
+  --status)
+    PID=$(lsof -ti tcp:$MCP_PORT 2>/dev/null)
+    if [ -n "$PID" ]; then
+      CMD=$(ps -p "$PID" -o args= 2>/dev/null)
+      if echo "$CMD" | grep -q -- "--headless"; then
+        MODE="headless"
+      else
+        MODE="headed"
+      fi
+      echo "mcp: running (PID $PID, mode: $MODE)"
+    else
+      echo "mcp: not running"
+    fi
+    exit 0
+    ;;
+  --headed)
+    MODE_FLAG=""
+    ;;
+  *)
+    MODE_FLAG="--headless"
+    ;;
+esac
+
+PID=$(lsof -ti tcp:$MCP_PORT 2>/dev/null)
+if [ -n "$PID" ]; then
+  CMD=$(ps -p "$PID" -o args= 2>/dev/null)
+  if echo "$CMD" | grep -q -- "--headless"; then
+    CURRENT="headless"
+  else
+    CURRENT="headed"
+  fi
+  DESIRED="${MODE_FLAG:+headless}"
+  DESIRED="${DESIRED:-headed}"
+  if [ "$CURRENT" = "$DESIRED" ]; then
+    echo "mcp: already running ($CURRENT mode, PID $PID)"
+    exit 0
+  fi
+  kill -9 "$PID" 2>/dev/null
+  sleep 1
+fi
+
+if [ -x "$BIN" ]; then
+  nohup "$BIN" --port "$MCP_PORT" $MODE_FLAG --isolated > /tmp/playwright-mcp.log 2>&1 &
+else
+  nohup npx @playwright/mcp --port "$MCP_PORT" $MODE_FLAG > /tmp/playwright-mcp.log 2>&1 &
+fi
+
+sleep 2
+NEW_PID=$(lsof -ti tcp:$MCP_PORT 2>/dev/null)
+if [ -n "$NEW_PID" ]; then
+  echo "mcp: started (PID $NEW_PID, mode: ${MODE_FLAG:-headed})"
+else
+  echo "mcp: failed to start — see /tmp/playwright-mcp.log"
+  exit 1
+fi

package/dist/hooks/reef-auto-format.sh.tmpl

@@ -0,0 +1,72 @@
+#!/bin/bash
+# reef-auto-format.sh
+# PostToolUse: 在 Edit/Write 后自动格式化代码
+#
+# 从 stdin JSON 解析文件路径（标准 Claude Code hook 协议），
+# 同时支持 $CLAUDE_CODE_TOOL_RESULT_FILEPATH 环境变量作为降级。
+#
+# 性能优先：单文件格式化 > 全项目格式化
+#   Java:   按 reef code-style 人工控制，不自动格式化
+#   Python: ruff format > black
+#   TS/JS:  eslint --fix
+
+set -euo pipefail
+
+# ── 1. 获取文件路径 ──────────────────────────────────────────────────
+# 优先从 stdin JSON 解析（PostToolUse 标准协议），降级到环境变量
+filepath=""
+
+# 尝试从 stdin 读取（PostToolUse hook JSON）
+if [ -p /dev/stdin ] && command -v jq &>/dev/null; then
+  filepath=$(jq -r '.tool_response.filePath // .tool_input.file_path // ""' 2>/dev/null || true)
+fi
+
+# 降级：环境变量
+if [ -z "$filepath" ] || [ "$filepath" = "null" ]; then
+  filepath="${CLAUDE_CODE_TOOL_RESULT_FILEPATH:-}"
+fi
+
+# 仍然拿不到路径，退出
+[ -z "$filepath" ] && exit 0
+[ ! -f "$filepath" ] && exit 0
+
+# 检测项目根目录
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# ── 2. 按文件类型执行格式化 ──────────────────────────────────────────
+
+case "$filepath" in
+  *.java)
+    # Java: 按 reef code-style 人工控制，不执行自动格式化
+    : # no-op
+    ;;
+  *.py)
+    if command -v ruff &>/dev/null; then
+      ruff format "$filepath"
+    elif command -v black &>/dev/null; then
+      black "$filepath"
+    fi
+    ;;
+  *.ts|*.tsx|*.html|*.css|*.scss|*.less|*.json|*.yaml|*.yml)
+    if ! command -v npx &>/dev/null; then
+      exit 0
+    fi
+    remaining=$(cd "$PROJECT_DIR" && npx eslint --fix "$filepath" 2>/dev/null || true)
+    if [ -n "$remaining" ]; then
+      echo "[auto-format] ⚠ 以下 ESLint 错误需要手动修复："
+      echo "$remaining"
+      echo "[auto-format] 请运行 {{reef.frontend.framework.formatCmd}} lint 查看完整报告。"
+    fi
+    ;;
+  *.go)
+    command -v gofmt &>/dev/null && gofmt -w "$filepath"
+    ;;
+  *.rs)
+    command -v rustfmt &>/dev/null && rustfmt "$filepath"
+    ;;
+  *.sql)
+    # 如果项目配置了 SQL 格式化工具，在此扩展
+    ;;
+esac
+
+exit 0

package/dist/hooks/reef-block-dangerous.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# reef-block-dangerous.sh
+# PreToolUse: 拦截危险的 Bash 命令
+
+INPUT=$(cat)
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // ""') || exit 0
+
+[ -z "$COMMAND" ] && exit 0
+
+DANGEROUS_PATTERNS=(
+  "rm -rf /"
+  "rm -rf ~"
+  "rm -rf \$HOME"
+  "rm -rf /*"
+  "> /dev/sd"
+  "mkfs."
+  "dd if="
+  ":(){:|:&};:"
+  "chmod -R 777 /"
+  "chown -R"
+  "git push --force origin main"
+  "git push --force origin master"
+  "git reset --hard origin"
+)
+
+# sed -i 修改敏感文件（.env、lock 文件等）
+if echo "$COMMAND" | grep -qE "sed\s+-i.*\.env|sed\s+-i.*lock\.json|sed\s+-i.*lock\.yaml"; then
+  cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "Blocked: sed -i on protected file (.env or lock file)"
+  }
+}
+EOF
+  exit 0
+fi
+
+for pattern in "${DANGEROUS_PATTERNS[@]}"; do
+  if [[ "$COMMAND" == *"$pattern"* ]]; then
+    cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "Blocked dangerous command pattern: $pattern"
+  }
+}
+EOF
+    exit 0
+  fi
+done
+
+# regex: curl/wget 管道到 sh/bash
+if echo "$COMMAND" | grep -qE '(curl|wget)\s+\S.*\|\s*(sh|bash)\b'; then
+  cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "Blocked dangerous command: pipe from curl/wget to shell"
+  }
+}
+EOF
+  exit 0
+fi
+
+# 默认放行
+exit 0

package/dist/hooks/reef-hooks.json

@@ -0,0 +1,72 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-intent-detect.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-block-dangerous.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-protect-files.sh"
+          },
+          {
+            "type": "prompt",
+            "timeout": 5,
+            "prompt": "You are about to write or edit a file. If the target file extension is .java, load reef-style-backend skill for coding standards. If the target is .ts, .html, .css, .scss, or .less, load reef-style-frontend skill for coding standards. Follow the loaded skill's rules in your output."
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-auto-format.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-run-tests.sh",
+            "if": "Edit(*.ts)|Write(*.ts)",
+            "async": true,
+            "statusMessage": "Running tests..."
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ./reef-run-tests.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/hooks/reef-intent-detect.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+# reef-intent-detect.sh
+# UserPromptSubmit hook: 检测用户输入是否为开发需求，自动唤起 reef-start skill
+#
+# 部署路径：.claude/hooks/reef-intent-detect.sh
+# 注册方式：通过 hooks.json 的 UserPromptSubmit 条目
+#
+# 工作原理：
+#   1. 读取用户输入（环境变量 CLAUDE_INPUT）
+#   2. 匹配开发意图关键词（中文 + 英文）
+#   3. 匹配成功 → 输出 <system-reminder> 指令，指示 AI 调用 reef-start skill
+#   4. 未匹配 → 静默退出，AI 正常处理
+
+# 严格模式
+set -euo pipefail
+
+# ── 配置：开发意图关键词 ──────────────────────────────────────────
+# 用户可以在此扩展关键词列表，添加新的匹配模式
+
+# 中文开发意图关键词
+ZH_DEV_PATTERNS=(
+  # 新增功能
+  "我想加" "我要加" "我需要" "帮我加" "帮我做" "帮我写"
+  "加个" "搞个" "写个" "做个" "弄个"
+  "加一个" "添加一个" "新增一个" "实现一个"
+  "实现一下" "实现个" "帮我实现"
+  "新增" "添加" "创建" "建立"
+  "做个功能" "加个功能" "来个功能"
+
+  # Bug 修复
+  "修复" "修一下" "修一个" "修好" "修修"
+  "有问题" "有bug" "有 bug" "不正常" "有毛病"
+  "返回不对" "结果不对" "数据不对"
+  "报错" "报错了" "出错了" "出错"
+  "不工作" "不能用了" "坏了" "挂了"
+  "bug" "Bug" "BUG"
+
+  # 重构/优化
+  "重构" "重写" "重做" "改造" "重改"
+  "优化" "改善" "提升" "改进"
+  "整理" "提取" "抽取" "拆分" "合并"
+  "重新设计" "重新组织" "重构成"
+  "改一下" "修改一下" "改动" "调整一下"
+
+  # 代码修改
+  "改成" "改为" "修改为" "变更"
+  "把这个" "把那个" "把这些"
+  "改代码" "写代码" "敲代码" "编码"
+  "代码有点" "逻辑有点" "写法有点"
+)
+
+# 英文开发意图关键词
+EN_DEV_PATTERNS=(
+  # New features
+  "add a" "add an" "add some" "add new"
+  "implement" "build a" "build an" "create a" "create an"
+  "new feature" "i need a" "i want a" "i need to"
+  "develop a" "write a" "write an" "make a"
+  "introduce" "set up" "set up a"
+
+  # Bug fixes
+  "fix" "bug" "broken" "not working" "doesn't work"
+  "error" "issue with" "problem with" "something wrong"
+  "fail" "failing" "failed" "crash" "crashed"
+
+  # Refactoring
+  "refactor" "rewrite" "restructure" "redesign"
+  "optimize" "optimise" "improve" "clean up" "cleanup"
+  "extract" "split" "merge" "reorganize" "reorganise"
+)
+
+# Issue 引用模式（如 LC-1234、PROJ-456、https://*.atlassian.net/browse/*）
+# 这些通常出现在用户提及具体开发任务时
+ISSUE_PATTERNS=(
+  "[A-Z]+-[0-9]+"
+  "atlassian.net/browse/"
+)
+
+# ── 配置：排除规则（匹配以下模式时不触发） ──────────────────────
+# 这些是常见的非开发意图表达，即使包含开发关键词也不触发
+
+EXCLUDE_PATTERNS=(
+  # 纯查询/查看类（排除过于宽泛的词，仅保留明确非开发意图的短语）
+  "查一下" "查查" "看看" "看一下"
+  "读一下" "读读"
+  "显示一下" "展示一下"
+
+  # 文档/配置查询
+  "怎么配置" "怎么设置" "怎么安装"
+  "配置方法" "使用方法" "怎么用"
+  "是什么意思" "的含义" "的定义"
+
+  # 系统命令 / slash 命令（避免重复触发）
+  "^/" "^opsx:" "^bmad" "^reef-"
+  "^deepflow-" "^gstack" "^review" "^qa"
+  "^ship" "^canary" "^retro" "^learn"
+)
+
+# ── 主逻辑 ────────────────────────────────────────────────────────
+
+# 读取用户输入
+MESSAGE="${CLAUDE_INPUT:-}"
+[ -z "$MESSAGE" ] && exit 0
+
+# 第一步：检查排除规则
+for pattern in "${EXCLUDE_PATTERNS[@]}"; do
+  if echo "$MESSAGE" | grep -qiE "$pattern"; then
+    exit 0  # 静默通过
+  fi
+done
+
+# 第二步：匹配开发意图关键词（含 Issue 引用）
+for pattern in "${ZH_DEV_PATTERNS[@]}" "${EN_DEV_PATTERNS[@]}" "${ISSUE_PATTERNS[@]}"; do
+  if echo "$MESSAGE" | grep -qiE "$pattern"; then
+    # 匹配成功 → 注入指令让 AI 调用 reef-start
+    cat <<'HOOKEOF'
+<system-reminder>
+The user's message indicates a development task (feature request / bug fix / refactoring).
+IMPORTANT: Before responding, you MUST invoke the reef-start skill using the Skill tool.
+Pass the user's original message as context to the skill.
+Only skip if reef-start is already active or you are already in a development flow.
+</system-reminder>
+HOOKEOF
+    exit 0
+  fi
+done
+
+# 未匹配 → 静默退出
+exit 0