blast-radius-analyzer 1.2.1

package/src/types.ts

@@ -0,0 +1,163 @@
+/**
+ * Blast Radius Analyzer - Type Definitions
+ * 分析代码改动影响范围的核心类型
+ */
+
+// ─── 改动信息 ────────────────────────────────────────────────────────────────
+
+export interface CodeChange {
+  file: string;
+  type: ChangeType;
+  symbol?: string;         // 改动的符号名 (function/class/interface)
+  line?: number;
+  diff?: string;           // 具体的 diff 内容
+}
+
+export type ChangeType =
+  | 'add'           // 新增文件/代码
+  | 'delete'        // 删除
+  | 'modify'        // 修改
+  | 'rename';        // 重命名
+
+// ─── 依赖图 ──────────────────────────────────────────────────────────────────
+
+export interface DependencyNode {
+  id: string;              // 文件路径或符号ID
+  kind: NodeKind;
+  file?: string;
+  line?: number;
+  exports?: string[];      // 导出的符号
+  imports?: ImportInfo[];
+  dependents: string[];    // 依赖此节点的节点 (反向索引)
+  depth: number;           // 到改动点的距离
+}
+
+export type NodeKind =
+  | 'file'
+  | 'function'
+  | 'class'
+  | 'interface'
+  | 'type'
+  | 'variable'
+  | 'export';
+
+export interface ImportInfo {
+  source: string;
+  imported: string[];
+  isReExport: boolean;
+}
+
+export interface DependencyGraph {
+  nodes: Map<string, DependencyNode>;
+  edges: Edge[];
+  entryPoints: string[];   // 入口文件 (main/app entry)
+}
+
+export interface Edge {
+  from: string;
+  to: string;
+  type: EdgeType;
+  symbol?: string;         // 如果是符号级别的依赖
+}
+
+export type EdgeType =
+  | 'import'               // import { x } from 'y'
+  | 'extend'               // class A extends B
+  | 'implement'            // class A implements B
+  | 'type-ref'             // type X = Y
+  | 'call'                 // A() 调用
+  | 'property-access'      // A.b 属性访问
+  | 'param-type';          // 参数类型引用
+
+// ─── 影响范围评估 ────────────────────────────────────────────────────────────
+
+export interface ImpactScope {
+  changedFile: string;
+  timestamp: string;
+
+  // 影响统计
+  stats: ImpactStats;
+
+  // 受影响的层级
+  levels: ImpactLevel[];
+
+  // 详细的受影响文件
+  affectedFiles: AffectedFile[];
+
+  // 传播路径 (从改动到每个受影响点的路径)
+  propagationPaths: PropagationPath[];
+
+  // 高风险影响
+  highRiskImpacts: HighRiskImpact[];
+
+  // 建议
+  recommendations: string[];
+}
+
+export interface ImpactStats {
+  totalAffectedFiles: number;
+  directDependencies: number;      // 直接依赖
+  transitiveDependencies: number;  // 传递依赖
+  filesWithBreakingChanges: number;
+  criticalFiles: number;           // 关键文件 (入口/配置)
+  estimatedRippleDepth: number;    // 预计涟漪深度
+}
+
+export interface ImpactLevel {
+  depth: number;                   // 距离改动的深度
+  description: string;
+  files: string[];
+  nodeCount: number;
+}
+
+export interface AffectedFile {
+  file: string;
+  kind: NodeKind;
+  changeType: ChangeType;
+  impactLevel: number;             // 1 = 直接依赖, 2 = 传递依赖, etc.
+  impactFactors: ImpactFactor[];
+  line?: number;                   // 最可能受影响的行
+}
+
+export interface ImpactFactor {
+  factor: string;
+  weight: number;                  // 0-1, 影响权重
+  reason: string;
+}
+
+export interface PropagationPath {
+  from: string;
+  to: string;
+  path: string[];                  // 完整的传播路径
+  edgeTypes: EdgeType[];
+  riskLevel: RiskLevel;
+}
+
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+
+export interface HighRiskImpact {
+  file: string;
+  reason: string;
+  riskLevel: RiskLevel;
+  mitigation?: string;
+}
+
+// ─── 配置 ────────────────────────────────────────────────────────────────────
+
+export interface AnalyzerConfig {
+  projectRoot: string;
+  tsConfigPath?: string;
+
+  // 分析范围
+  maxDepth: number;                // 最大分析深度
+  includeNodeModules: boolean;    // 是否分析 node_modules
+  includeTests: boolean;          // 是否分析测试文件
+
+  // 风险评估
+  criticalPatterns: string[];      // 关键文件模式 (如 **/main.ts, **/index.ts)
+  ignorePatterns: string[];        // 忽略的分析模式
+
+  // 输出
+  verbose: boolean;
+  outputFormat: 'json' | 'text' | 'html' | 'graph';
+}

package/test-cases/.blast-radius-cache/file-states.json

@@ -0,0 +1,14 @@
+{
+  "/Users/didi/Documents/code3/logic-inverse-v2/blast-radius-analyzer/test-cases/nested.ts": {
+    "mtime": 1774883918653.3655,
+    "hash": "7bfe575d"
+  },
+  "/Users/didi/Documents/code3/logic-inverse-v2/blast-radius-analyzer/test-cases/simple.ts": {
+    "mtime": 1774881971275.246,
+    "hash": "88ca972"
+  },
+  "/Users/didi/Documents/code3/logic-inverse-v2/blast-radius-analyzer/test-cases/config.ts": {
+    "mtime": 1774882783262.9082,
+    "hash": "3ff6da2a"
+  }
+}

package/test-cases/config.ts

@@ -0,0 +1,13 @@
+// Test case: Constants and types
+export const API_BASE_URL = 'https://api.example.com';
+
+export const MAX_RETRIES = 3;
+
+export type UserStatus = 'active' | 'inactive' | 'pending';
+
+export const DEFAULT_USER: UserStatus = 'pending';
+
+export const CONFIG = {
+  timeout: 5000,
+  retries: 3,
+};

package/test-cases/consumer.ts

@@ -0,0 +1,12 @@
+import { API_BASE_URL, MAX_RETRIES, UserStatus, CONFIG } from './config';
+
+export const fetchUser = async (id: string): Promise<any> => {
+  const url = `${API_BASE_URL}/users/${id}`;
+  // Use MAX_RETRIES
+  for (let i = 0; i < MAX_RETRIES; i++) {
+    // retry logic
+  }
+  return { url, status: 'active' as UserStatus };
+};
+
+export const getConfig = () => CONFIG.timeout;

package/test-cases/nested.ts

@@ -0,0 +1,25 @@
+// Complex test: nested property access
+export const config = {
+  api: {
+    baseUrl: 'https://api.example.com',
+    timeout: 5000,
+  },
+  db: {
+    host: 'localhost',
+    port: 5432,
+  },
+};
+
+// Class with methods
+export class UserService {
+  private apiUrl = config.api.baseUrl;
+
+  getUser(id: string) {
+    return fetch(`${this.apiUrl}/users/${id}`);
+  }
+}
+
+// Function using dynamic property
+export const getConfig = (key: string) => {
+  return (config as any)[key];
+};

package/test-cases/simple.ts

@@ -0,0 +1,62 @@
+// Test Case 1: Simple function (no branches)
+export const add = (a: number, b: number): number => {
+  return a + b;
+};
+
+// Test Case 2: Function with type narrowing
+export const processData = (data: string | null): number => {
+  if (data != null) {
+    return data.length;
+  }
+  return 0;
+};
+
+// Test Case 3: Function with branches
+export const classify = (score: number): string => {
+  if (score >= 90) {
+    return 'A';
+  } else if (score >= 80) {
+    return 'B';
+  } else if (score >= 70) {
+    return 'C';
+  } else {
+    return 'D';
+  }
+};
+
+// Test Case 4: Function with loop
+export const sumArray = (arr: number[]): number => {
+  let sum = 0;
+  for (const num of arr) {
+    sum += num;
+  }
+  return sum;
+};
+
+// Test Case 5: Function with try-catch
+export const safeParse = (json: string): any => {
+  try {
+    return JSON.parse(json);
+  } catch (e) {
+    return null;
+  }
+};
+
+// Test Case 6: Async function
+export const fetchData = async (url: string): Promise<any> => {
+  const response = await fetch(url);
+  return response.json();
+};
+
+// Test Case 7: Taint source simulation
+export const processUserInput = (input: string): string => {
+  return input.replace(/[<>]/g, '');
+};
+
+// Test Case 8: Function with multiple return paths
+export const divide = (a: number, b: number): number | null => {
+  if (b === 0) {
+    return null;
+  }
+  return a / b;
+};

package/test-cases/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "strict": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["./**/*.ts"]
+}

package/test-cases/user.ts

@@ -0,0 +1,32 @@
+// Test Case 9: Consumer of simple functions
+import { add, processData, classify, sumArray, safeParse, processUserInput, divide } from './simple';
+
+export const calculate = () => {
+  const result = add(1, 2);
+  return result;
+};
+
+export const handleData = () => {
+  const len = processData("hello");
+  return len;
+};
+
+export const grade = () => {
+  return classify(95);
+};
+
+export const total = () => {
+  return sumArray([1, 2, 3, 4, 5]);
+};
+
+export const parse = () => {
+  return safeParse('{"key": "value"}');
+};
+
+export const sanitize = () => {
+  return processUserInput('<script>alert(1)</script>');
+};
+
+export const division = () => {
+  return divide(10, 2);
+};

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}