super-dev 2.0.9__tar.gz → 2.0.10__tar.gz

{super_dev-2.0.9/super_dev.egg-info → super_dev-2.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: super-dev
-Version: 2.0.9
+Version: 2.0.10
 Summary: Super Dev - Pipeline AI Coding Assistant
 Author-email: Excellent <11964948@qq.com>
 License-Expression: MIT
@@ -60,7 +60,16 @@ Dynamic: license-file
 
 ## 版本
 
-当前版本：`2.0.9`
+当前版本：`2.0.10`
+
+---
+
+## 演示视频
+
+<video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>
+
+- 在线播放：[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
+- 仓库文件：[demo.mp4](demo.mp4)
 
 ---
 
@@ -168,6 +177,9 @@ super-dev
 ```bash
 super-dev integrate audit --auto --repair --force
 super-dev integrate validate --auto
+super-dev repo-map
+super-dev impact "修改登录流程" --files services/auth.py
+super-dev fix "修复登录接口 500 并补充回归验证"
 super-dev release proof-pack
 super-dev release readiness
 super-dev review architecture --status revision_requested --comment "技术方案需要重构"
@@ -207,13 +219,13 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.0.9
+pip install super-dev==2.0.10
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.9
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.10
 ```
 
 ### 5. 源码开发安装
@@ -336,6 +348,9 @@ uv tool install super-dev
 2. Claude Code / Gemini CLI / Kiro CLI / Qoder CLI / CodeBuddy CLI 等支持原生映射的宿主，可直接输入：`/super-dev 你的需求`。
 3. Codex CLI、Kimi CLI 当前不使用 `/super-dev`；在宿主会话里输入 `super-dev: 你的需求`。
 4. 宿主会先被约束执行“同类产品研究 -> 三文档 -> 等待用户确认 -> Spec -> 前端运行验证 -> 后端/测试/交付”，不会直接跳到写代码。
+5. 如果是缺陷修复，优先使用 `super-dev fix "缺陷描述"`，走轻量 bugfix 路径，而不是完整功能开发路径。
+6. 接手已有项目或复杂仓库时，优先执行 `super-dev repo-map` 生成代码库地图，再让宿主进入开发。
+7. 如果准备重构、改接口、修登录流或修改关键状态流，先执行 `super-dev impact "变更描述" --files ...` 评估影响范围，再动手。
 
 ### 宿主如何理解 Super Dev
 

{super_dev-2.0.9 → super_dev-2.0.10}/README.md

@@ -19,7 +19,16 @@
 
 ## 版本
 
-当前版本：`2.0.9`
+当前版本：`2.0.10`
+
+---
+
+## 演示视频
+
+<video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>
+
+- 在线播放：[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
+- 仓库文件：[demo.mp4](demo.mp4)
 
 ---
 
@@ -127,6 +136,9 @@ super-dev
 ```bash
 super-dev integrate audit --auto --repair --force
 super-dev integrate validate --auto
+super-dev repo-map
+super-dev impact "修改登录流程" --files services/auth.py
+super-dev fix "修复登录接口 500 并补充回归验证"
 super-dev release proof-pack
 super-dev release readiness
 super-dev review architecture --status revision_requested --comment "技术方案需要重构"
@@ -166,13 +178,13 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.0.9
+pip install super-dev==2.0.10
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.9
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.10
 ```
 
 ### 5. 源码开发安装
@@ -295,6 +307,9 @@ uv tool install super-dev
 2. Claude Code / Gemini CLI / Kiro CLI / Qoder CLI / CodeBuddy CLI 等支持原生映射的宿主，可直接输入：`/super-dev 你的需求`。
 3. Codex CLI、Kimi CLI 当前不使用 `/super-dev`；在宿主会话里输入 `super-dev: 你的需求`。
 4. 宿主会先被约束执行“同类产品研究 -> 三文档 -> 等待用户确认 -> Spec -> 前端运行验证 -> 后端/测试/交付”，不会直接跳到写代码。
+5. 如果是缺陷修复，优先使用 `super-dev fix "缺陷描述"`，走轻量 bugfix 路径，而不是完整功能开发路径。
+6. 接手已有项目或复杂仓库时，优先执行 `super-dev repo-map` 生成代码库地图，再让宿主进入开发。
+7. 如果准备重构、改接口、修登录流或修改关键状态流，先执行 `super-dev impact "变更描述" --files ...` 评估影响范围，再动手。
 
 ### 宿主如何理解 Super Dev
 

{super_dev-2.0.9 → super_dev-2.0.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "super-dev"
-version = "2.0.9"
+version = "2.0.10"
 description = "Super Dev - Pipeline AI Coding Assistant"
 readme = "README.md"
 requires-python = ">=3.10"

{super_dev-2.0.9 → super_dev-2.0.10}/super_dev/__init__.py

@@ -6,6 +6,6 @@
 最后修改：2025-12-30
 """
 
-__version__ = "2.0.9"
+__version__ = "2.0.10"
 __author__ = "Excellent"
 __description__ = "超级开发战队 - 一个宿主内 AI 开发治理与编排工具"

{super_dev-2.0.9 → super_dev-2.0.10}/super_dev/analyzer/__init__.py

@@ -15,6 +15,8 @@ from .models import (
     ProjectType,
     TechStack,
 )
+from .repo_map import RepoMapBuilder, RepoMapItem, RepoMapReport
+from .impact import ImpactAnalyzer, ImpactAnalysisReport, ImpactItem
 
 __all__ = [
     "ProjectAnalyzer",
@@ -27,8 +29,12 @@ __all__ = [
     "TechStack",
     "FrameworkType",
     "ArchitecturePattern",
+    "RepoMapBuilder",
+    "RepoMapItem",
+    "RepoMapReport",
+    "ImpactAnalyzer",
+    "ImpactAnalysisReport",
+    "ImpactItem",
     "detect_project_type",
     "detect_tech_stack",
 ]
-
-

super_dev-2.0.10/super_dev/analyzer/impact.py

@@ -0,0 +1,255 @@
+from __future__ import annotations
+
+import json
+import re
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+from .repo_map import RepoMapBuilder, RepoMapItem
+
+
+def _tokenize(text: str) -> set[str]:
+    return {token for token in re.split(r"[^a-zA-Z0-9_\-/]+", text.lower()) if token}
+
+
+@dataclass
+class ImpactItem:
+    name: str
+    path: str
+    reason: str
+    category: str
+    confidence: float
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "name": self.name,
+            "path": self.path,
+            "reason": self.reason,
+            "category": self.category,
+            "confidence": self.confidence,
+        }
+
+
+@dataclass
+class ImpactAnalysisReport:
+    project_name: str
+    project_path: str
+    description: str
+    files: list[str]
+    risk_level: str
+    summary: str
+    affected_modules: list[ImpactItem] = field(default_factory=list)
+    affected_entry_points: list[ImpactItem] = field(default_factory=list)
+    affected_integration_surfaces: list[ImpactItem] = field(default_factory=list)
+    regression_focus: list[str] = field(default_factory=list)
+    recommended_steps: list[str] = field(default_factory=list)
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "project_name": self.project_name,
+            "project_path": self.project_path,
+            "description": self.description,
+            "files": self.files,
+            "risk_level": self.risk_level,
+            "summary": self.summary,
+            "affected_modules": [item.to_dict() for item in self.affected_modules],
+            "affected_entry_points": [item.to_dict() for item in self.affected_entry_points],
+            "affected_integration_surfaces": [item.to_dict() for item in self.affected_integration_surfaces],
+            "regression_focus": list(self.regression_focus),
+            "recommended_steps": list(self.recommended_steps),
+        }
+
+    def to_markdown(self) -> str:
+        lines = [
+            "# Change Impact Analysis",
+            "",
+            f"- Project: `{self.project_name}`",
+            f"- Path: `{self.project_path}`",
+            f"- Risk Level: `{self.risk_level}`",
+        ]
+        if self.description:
+            lines.append(f"- Change: {self.description}")
+        if self.files:
+            lines.append(f"- Files: {', '.join(f'`{f}`' for f in self.files)}")
+        lines.extend(["", self.summary, ""])
+        self._append_items(lines, "Affected Modules", self.affected_modules)
+        self._append_items(lines, "Affected Entry Points", self.affected_entry_points)
+        self._append_items(lines, "Affected Integration Surfaces", self.affected_integration_surfaces)
+        lines.extend(["", "## Regression Focus", ""])
+        if self.regression_focus:
+            for item in self.regression_focus:
+                lines.append(f"- {item}")
+        else:
+            lines.append("- No explicit regression focus was inferred.")
+        lines.extend(["", "## Recommended Steps", ""])
+        for item in self.recommended_steps:
+            lines.append(f"- {item}")
+        lines.append("")
+        return "\n".join(lines)
+
+    @staticmethod
+    def _append_items(lines: list[str], title: str, items: list[ImpactItem]) -> None:
+        lines.extend(["", f"## {title}", ""])
+        if not items:
+            lines.append("- None")
+            return
+        for item in items:
+            lines.append(f"- **{item.name}**: `{item.path}`")
+            lines.append(f"  - {item.reason} (confidence={item.confidence:.2f})")
+
+
+class ImpactAnalyzer:
+    def __init__(self, project_dir: Path):
+        self.project_dir = Path(project_dir).resolve()
+        self.output_dir = self.project_dir / "output"
+        self.output_dir.mkdir(parents=True, exist_ok=True)
+        self.project_name = self.project_dir.name
+        self.repo_map_builder = RepoMapBuilder(self.project_dir)
+
+    def build(self, description: str = "", files: list[str] | None = None) -> ImpactAnalysisReport:
+        files = [file for file in (files or []) if file]
+        repo_map = self.repo_map_builder.build()
+        description_tokens = _tokenize(description)
+        normalized_files = [str(Path(file)).replace("\\", "/") for file in files]
+
+        affected_modules = self._score_repo_items(repo_map.top_modules, normalized_files, description_tokens, "module")
+        affected_entry_points = self._score_repo_items(repo_map.entry_points, normalized_files, description_tokens, "entry-point")
+        affected_surfaces = self._score_repo_items(repo_map.integration_surfaces, normalized_files, description_tokens, "integration-surface")
+
+        risk_level = self._risk_level(affected_modules, affected_entry_points, affected_surfaces)
+        summary = self._summary(description, normalized_files, risk_level, affected_modules, affected_entry_points, affected_surfaces)
+        regression_focus = self._regression_focus(affected_modules, affected_surfaces, normalized_files)
+        recommended_steps = self._recommended_steps(risk_level, affected_modules, affected_surfaces, normalized_files)
+
+        return ImpactAnalysisReport(
+            project_name=self.project_name,
+            project_path=str(self.project_dir),
+            description=description,
+            files=normalized_files,
+            risk_level=risk_level,
+            summary=summary,
+            affected_modules=affected_modules,
+            affected_entry_points=affected_entry_points,
+            affected_integration_surfaces=affected_surfaces,
+            regression_focus=regression_focus,
+            recommended_steps=recommended_steps,
+        )
+
+    def write(self, report: ImpactAnalysisReport) -> dict[str, Path]:
+        md_path = self.output_dir / f"{self.project_name}-impact-analysis.md"
+        json_path = self.output_dir / f"{self.project_name}-impact-analysis.json"
+        md_path.write_text(report.to_markdown(), encoding="utf-8")
+        json_path.write_text(json.dumps(report.to_dict(), ensure_ascii=False, indent=2), encoding="utf-8")
+        return {"markdown": md_path, "json": json_path}
+
+    def _score_repo_items(
+        self,
+        items: list[RepoMapItem],
+        files: list[str],
+        description_tokens: set[str],
+        category: str,
+    ) -> list[ImpactItem]:
+        scored: list[ImpactItem] = []
+        for item in items:
+            confidence = 0.0
+            reasons: list[str] = []
+            item_path = item.path.replace("\\", "/").lower()
+            item_tokens = _tokenize(f"{item.name} {item.path} {item.summary}")
+
+            for file in files:
+                file_lower = file.lower()
+                top = file_lower.split("/")[0]
+                if item_path == file_lower or item_path.startswith(file_lower) or file_lower.startswith(item_path):
+                    confidence = max(confidence, 0.95)
+                    reasons.append("direct file/path overlap")
+                elif item_path == top or item_path.startswith(f"{top}/") or top == item_path:
+                    confidence = max(confidence, 0.82)
+                    reasons.append("same top-level module as changed file")
+
+            overlap = description_tokens & item_tokens
+            if overlap:
+                confidence = max(confidence, min(0.75, 0.45 + 0.08 * len(overlap)))
+                reasons.append(f"keyword overlap: {', '.join(sorted(list(overlap))[:4])}")
+
+            if confidence > 0:
+                scored.append(
+                    ImpactItem(
+                        name=item.name,
+                        path=item.path,
+                        reason="; ".join(dict.fromkeys(reasons)),
+                        category=category,
+                        confidence=round(confidence, 2),
+                    )
+                )
+
+        scored.sort(key=lambda item: item.confidence, reverse=True)
+        return scored[:6]
+
+    @staticmethod
+    def _risk_level(
+        modules: list[ImpactItem],
+        entry_points: list[ImpactItem],
+        surfaces: list[ImpactItem],
+    ) -> str:
+        score = 0
+        score += len([item for item in modules if item.confidence >= 0.8]) * 2
+        score += len([item for item in entry_points if item.confidence >= 0.7]) * 2
+        score += len([item for item in surfaces if item.confidence >= 0.7]) * 3
+        if score >= 8:
+            return "high"
+        if score >= 4:
+            return "medium"
+        return "low"
+
+    @staticmethod
+    def _summary(
+        description: str,
+        files: list[str],
+        risk_level: str,
+        modules: list[ImpactItem],
+        entry_points: list[ImpactItem],
+        surfaces: list[ImpactItem],
+    ) -> str:
+        subject = description or ("、".join(files[:3]) if files else "this change")
+        return (
+            f"The requested change `{subject}` is assessed as `{risk_level}` risk. "
+            f"The strongest signals point to {len(modules)} affected modules, {len(entry_points)} entry points, "
+            f"and {len(surfaces)} integration surfaces that should be reviewed before implementation."
+        )
+
+    @staticmethod
+    def _regression_focus(modules: list[ImpactItem], surfaces: list[ImpactItem], files: list[str]) -> list[str]:
+        focus: list[str] = []
+        joined_paths = " ".join([item.path.lower() for item in modules + surfaces] + [file.lower() for file in files])
+        if any(token in joined_paths for token in ["auth", "login", "session", "permission"]):
+            focus.append("Authentication, session, and permission regression checks")
+        if any(token in joined_paths for token in ["api", "controller", "route", "router"]):
+            focus.append("API contract and route-level regression checks")
+        if any(token in joined_paths for token in ["component", "ui", "page", "screen", "view"]):
+            focus.append("Critical UI paths, navigation, and state transition checks")
+        if any(token in joined_paths for token in ["db", "database", "repository", "model", "entity"]):
+            focus.append("Data model, persistence, and migration regression checks")
+        if not focus:
+            focus.append("Smoke test the primary user flow and the modules most likely to be touched")
+        return focus
+
+    @staticmethod
+    def _recommended_steps(
+        risk_level: str,
+        modules: list[ImpactItem],
+        surfaces: list[ImpactItem],
+        files: list[str],
+    ) -> list[str]:
+        steps = [
+            "Read the repo map first to confirm the likely entry points and module boundaries.",
+            "Limit edits to the highest-confidence modules before expanding the scope.",
+        ]
+        if risk_level == "high":
+            steps.append("Freeze the affected surface in PRD / Architecture / UIUX or patch docs before coding.")
+        if surfaces:
+            steps.append("Re-test the affected integration surfaces before declaring the change complete.")
+        if files:
+            steps.append("Use the changed file list as the minimum review set, then inspect adjacent modules only if impact expands.")
+        steps.append("Rerun bugfix/runtime/quality validation after implementation.")
+        return steps