specops 0.2.5 → 0.3.2

package/dist/requirement-analysis/types/feature-mapping.d.ts

@@ -0,0 +1,294 @@
+/**
+ * 功能代码映射核心接口
+ * 基于 Oracle 架构设计的需求分析数据模型
+ */
+export interface FeatureCodeMapping {
+    /** 映射版本号 */
+    version: string;
+    /** 生成时间戳 */
+    generatedAt: string;
+    /** 代码库信息 */
+    repository: RepositoryInfo;
+    /** 功能映射列表 */
+    features: FeatureMap[];
+    /** 代码结构映射 */
+    codeStructure: CodeStructureMap;
+    /** 依赖关系图 */
+    dependencies: DependencyGraph;
+    /** 实现建议 */
+    recommendations: ImplementationRecommendation[];
+}
+export interface FeatureMap {
+    /** 功能ID，格式：SC-001, SC-002... */
+    id: string;
+    /** 功能名称 */
+    name: string;
+    /** 功能描述 */
+    description: string;
+    /** 优先级 */
+    priority: "high" | "medium" | "low";
+    /** 复杂度评估 */
+    complexity: "low" | "medium" | "high";
+    /** 代码映射信息 */
+    codeMapping: CodeMapping;
+    /** 实现计划 */
+    implementation: ImplementationPlan;
+}
+export interface RepositoryInfo {
+    /** 代码库名称 */
+    name: string;
+    /** 代码库路径 */
+    path: string;
+    /** Git 远程地址 */
+    remoteUrl?: string;
+    /** 主分支名称 */
+    mainBranch: string;
+    /** 最后提交哈希 */
+    lastCommit: string;
+    /** 代码库统计信息 */
+    stats: RepositoryStats;
+}
+export interface RepositoryStats {
+    /** 总文件数 */
+    totalFiles: number;
+    /** 总代码行数 */
+    totalLines: number;
+    /** 语言分布 */
+    languageDistribution: Record<string, number>;
+    /** 目录数量 */
+    directoryCount: number;
+    /** 最后修改时间 */
+    lastModified: string;
+}
+export interface CodeMapping {
+    /** 相关文件路径列表 */
+    relatedFiles: string[];
+    /** 核心组件列表 */
+    coreComponents: ComponentInfo[];
+    /** API 端点列表 */
+    apiEndpoints: ApiEndpoint[];
+    /** 数据模型列表 */
+    dataModels: DataModel[];
+    /** 配置文件列表 */
+    configFiles: string[];
+}
+export interface ComponentInfo {
+    /** 组件名称 */
+    name: string;
+    /** 组件类型 */
+    type: "component" | "service" | "utility" | "hook" | "store";
+    /** 文件路径 */
+    filePath: string;
+    /** 组件描述 */
+    description: string;
+    /** 依赖的其他组件 */
+    dependencies: string[];
+    /** 导出的接口 */
+    exports: string[];
+}
+export interface ApiEndpoint {
+    /** 端点路径 */
+    path: string;
+    /** HTTP 方法 */
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    /** 端点描述 */
+    description: string;
+    /** 请求参数 */
+    parameters: ParameterInfo[];
+    /** 响应格式 */
+    response: ResponseInfo;
+    /** 实现文件路径 */
+    implementationFile: string;
+}
+export interface ParameterInfo {
+    /** 参数名称 */
+    name: string;
+    /** 参数类型 */
+    type: string;
+    /** 是否必需 */
+    required: boolean;
+    /** 参数描述 */
+    description: string;
+    /** 默认值 */
+    defaultValue?: any;
+}
+export interface ResponseInfo {
+    /** 响应类型 */
+    type: string;
+    /** 响应描述 */
+    description: string;
+    /** 示例数据 */
+    example?: any;
+}
+export interface DataModel {
+    /** 模型名称 */
+    name: string;
+    /** 模型类型 */
+    type: "interface" | "type" | "class" | "enum";
+    /** 定义文件路径 */
+    filePath: string;
+    /** 字段列表 */
+    fields: FieldInfo[];
+    /** 模型描述 */
+    description: string;
+}
+export interface FieldInfo {
+    /** 字段名称 */
+    name: string;
+    /** 字段类型 */
+    type: string;
+    /** 是否可选 */
+    optional: boolean;
+    /** 字段描述 */
+    description: string;
+}
+export interface ImplementationPlan {
+    /** 实现步骤 */
+    steps: ImplementationStep[];
+    /** 预估工作量（小时） */
+    estimatedHours: number;
+    /** 技术风险评估 */
+    risks: RiskAssessment[];
+    /** 依赖的其他功能 */
+    dependencies: string[];
+    /** 验收标准 */
+    acceptanceCriteria: string[];
+}
+export interface ImplementationStep {
+    /** 步骤序号 */
+    order: number;
+    /** 步骤描述 */
+    description: string;
+    /** 涉及的文件 */
+    files: string[];
+    /** 预估时间（小时） */
+    estimatedHours: number;
+    /** 步骤类型 */
+    type: "create" | "modify" | "delete" | "test" | "deploy";
+}
+export interface RiskAssessment {
+    /** 风险描述 */
+    description: string;
+    /** 风险等级 */
+    level: "low" | "medium" | "high" | "critical";
+    /** 影响范围 */
+    impact: string;
+    /** 缓解措施 */
+    mitigation: string;
+}
+export interface CodeStructureMap {
+    /** 目录结构 */
+    directories: DirectoryNode[];
+    /** 架构模式 */
+    architecturePattern: string;
+    /** 代码组织方式 */
+    organizationStyle: "feature-based" | "layer-based" | "domain-based" | "mixed";
+    /** 关键路径分析 */
+    criticalPaths: CriticalPath[];
+}
+export interface DirectoryNode {
+    /** 目录名称 */
+    name: string;
+    /** 目录路径 */
+    path: string;
+    /** 目录类型 */
+    type: "source" | "test" | "config" | "docs" | "assets" | "build";
+    /** 子目录 */
+    children: DirectoryNode[];
+    /** 文件列表 */
+    files: FileNode[];
+    /** 目录描述 */
+    description: string;
+}
+export interface FileNode {
+    /** 文件名称 */
+    name: string;
+    /** 文件路径 */
+    path: string;
+    /** 文件类型 */
+    type: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** 最后修改时间 */
+    lastModified: string;
+    /** 文件重要性 */
+    importance: "critical" | "important" | "normal" | "low";
+}
+export interface CriticalPath {
+    /** 路径名称 */
+    name: string;
+    /** 路径描述 */
+    description: string;
+    /** 涉及的文件 */
+    files: string[];
+    /** 路径重要性 */
+    importance: "critical" | "high" | "medium" | "low";
+}
+export interface DependencyGraph {
+    /** 依赖节点列表 */
+    nodes: DependencyNode[];
+    /** 依赖边列表 */
+    edges: DependencyEdge[];
+    /** 循环依赖检测 */
+    circularDependencies: CircularDependency[];
+    /** 依赖层级 */
+    levels: DependencyLevel[];
+}
+export interface DependencyNode {
+    /** 节点ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型 */
+    type: "feature" | "component" | "service" | "external";
+    /** 节点描述 */
+    description: string;
+    /** 节点重要性 */
+    importance: "critical" | "high" | "medium" | "low";
+}
+export interface DependencyEdge {
+    /** 源节点ID */
+    from: string;
+    /** 目标节点ID */
+    to: string;
+    /** 依赖类型 */
+    type: "required" | "optional" | "weak";
+    /** 依赖描述 */
+    description: string;
+}
+export interface CircularDependency {
+    /** 循环路径 */
+    path: string[];
+    /** 严重程度 */
+    severity: "error" | "warning" | "info";
+    /** 建议解决方案 */
+    suggestion: string;
+}
+export interface DependencyLevel {
+    /** 层级编号 */
+    level: number;
+    /** 该层级的节点 */
+    nodes: string[];
+    /** 层级描述 */
+    description: string;
+}
+export interface ImplementationRecommendation {
+    /** 建议ID */
+    id: string;
+    /** 建议标题 */
+    title: string;
+    /** 建议描述 */
+    description: string;
+    /** 建议类型 */
+    type: "architecture" | "performance" | "security" | "maintainability" | "testing";
+    /** 优先级 */
+    priority: "high" | "medium" | "low";
+    /** 影响范围 */
+    impact: string[];
+    /** 实施成本 */
+    cost: "low" | "medium" | "high";
+    /** 预期收益 */
+    benefit: string;
+    /** 实施步骤 */
+    implementationSteps: string[];
+}

package/dist/requirement-analysis/types/feature-mapping.js

@@ -0,0 +1 @@
+export{};

package/dist/requirement-analysis/types/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 需求分析模块类型定义入口
+ * 基于 Oracle 架构设计的核心数据模型
+ */
+export type { FeatureCodeMapping, FeatureMap, RepositoryInfo, RepositoryStats, CodeMapping, ComponentInfo, ApiEndpoint, ParameterInfo, ResponseInfo, DataModel, FieldInfo, ImplementationPlan, ImplementationStep, RiskAssessment, CodeStructureMap, DirectoryNode, FileNode, CriticalPath, DependencyGraph, DependencyNode, DependencyEdge, CircularDependency, DependencyLevel, ImplementationRecommendation } from './feature-mapping.js';
+export type { TechStackDetection, DetectedTechnology, TechnologyType, DetectionSource, UsageLevel, TechStackCategories, VersionInfo, ConfigAnalysis, ConfigFile, EnvironmentConfig, BuildConfiguration, OptimizationConfig, DeploymentConfiguration, DetectionStats, TechStackRecommendation, ImpactAssessment } from './tech-stack.js';
+export type { RequirementAnalysisResult as FullRequirementAnalysisResult, ProjectInfo, ProjectType, ProjectScale, CodebaseStats, LanguageStats, FileTypeStats, DirectoryStats, ComplexityMetrics, ProjectMetadata, PRDGenerationResult, PRDSection, PRDSectionType, TemplateInfo, GenerationStats, GenerationError, QualityMetrics, QualityDimensions, QualityThresholds, ImprovementSuggestion, AnalysisStats, PhaseDuration, MemoryUsage, AnalysisConfig } from './analysis-result.js';
+export interface AnalysisOptions {
+    /** 包含代码分析 */
+    includeCodeAnalysis?: boolean;
+    /** 包含技术栈分析 */
+    includeTechStack?: boolean;
+    /** 包含功能映射 */
+    includeFeatureMapping?: boolean;
+    /** 生成PRD */
+    generatePRD?: boolean;
+    /** 输出格式 */
+    outputFormat?: 'markdown' | 'json' | 'html';
+    /** 分析深度 */
+    depth?: 'shallow' | 'medium' | 'deep';
+    /** 超时设置（秒） */
+    timeout?: number;
+}
+export interface TechStackAnalysis {
+    /** 检测到的技术 */
+    detected: Array<{
+        name: string;
+        type: string;
+        version?: string;
+        confidence: number;
+    }>;
+    /** 兼容性分析 */
+    compatibility: {
+        score: number;
+        issues: string[];
+        conflicts?: string[];
+        suggestions?: string[];
+    };
+    /** 推荐建议 */
+    recommendations: Array<{
+        type: string;
+        description: string;
+        priority: number;
+    }>;
+}
+export interface FeatureMappingResult {
+    /** 用户故事 */
+    userStories: Array<{
+        id: string;
+        asA: string;
+        iWant: string;
+        soThat: string;
+        priority: number;
+    }>;
+    /** 功能特性 */
+    features: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        priority?: number;
+        complexity?: number;
+        estimatedHours?: number;
+        category?: string;
+        userStories?: string[];
+        acceptanceCriteria?: string[];
+    }>;
+    /** 依赖关系 */
+    dependencies: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    /** 汇总信息 */
+    summary?: {
+        totalFeatures: number;
+        totalEstimatedHours: number;
+        complexityDistribution: Record<number, number>;
+    };
+}
+export interface PRDResult {
+    /** PRD内容 */
+    content: string;
+    /** 章节列表 */
+    sections: Array<{
+        id: string;
+        title: string;
+        content: string;
+        order: number;
+    }>;
+    /** 质量评分 */
+    qualityScore: {
+        overall: number;
+        completeness?: number;
+        clarity?: number;
+        feasibility?: number;
+        dimensions?: Record<string, number>;
+    };
+}
+export interface QualityScore {
+    /** 总体评分 */
+    overall: number;
+    /** 各维度评分 */
+    dimensions: {
+        featureCompleteness: number;
+        technicalFeasibility: number;
+        requirementClarity: number;
+        complexityReasonableness: number;
+    };
+}
+export interface RequirementAnalysisResult {
+    /** 项目信息 */
+    projectInfo: {
+        name: string;
+        type: string;
+        description: string;
+        repository?: string;
+    };
+    /** 代码库统计 */
+    codebaseStats: {
+        totalFiles: number;
+        totalLines: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        dependencies: Record<string, string>;
+    };
+    /** PRD结果 */
+    prdResult: {
+        sections: Array<{
+            id: string;
+            title: string;
+            content: string;
+            order: number;
+        }>;
+        qualityScore: {
+            completeness: number;
+            clarity: number;
+            feasibility: number;
+            overall: number;
+        };
+    };
+    /** 功能映射 */
+    featureMapping: {
+        userStories: Array<{
+            id: string;
+            asA: string;
+            iWant: string;
+            soThat: string;
+            priority: number;
+        }>;
+        features: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            priority?: number;
+            complexity?: number;
+            estimatedHours?: number;
+            category?: string;
+            userStories?: string[];
+            acceptanceCriteria?: string[];
+        }>;
+        dependencies: Array<{
+            from: string;
+            to: string;
+            type: string;
+        }>;
+    };
+    /** 技术栈分析 */
+    techStackAnalysis: TechStackAnalysis;
+    /** 分析选项 */
+    analysisOptions: AnalysisOptions;
+}

package/dist/requirement-analysis/types/index.js

@@ -0,0 +1 @@
+export{};

package/dist/requirement-analysis/types/tech-stack.d.ts

@@ -0,0 +1,213 @@
+/**
+ * 技术栈检测接口
+ * 基于 Oracle 架构设计的技术栈分析数据模型
+ */
+export interface TechStackDetection {
+    /** 检测版本号 */
+    version: string;
+    /** 检测时间戳 */
+    detectedAt: string;
+    /** 项目路径 */
+    projectPath: string;
+    /** 检测到的技术栈 */
+    detectedStack: DetectedTechnology[];
+    /** 技术栈分类 */
+    categories: TechStackCategories;
+    /** 版本信息 */
+    versions: VersionInfo[];
+    /** 配置文件分析 */
+    configAnalysis: ConfigAnalysis;
+    /** 检测统计 */
+    detectionStats: DetectionStats;
+}
+export interface DetectedTechnology {
+    /** 技术名称 */
+    name: string;
+    /** 技术类型 */
+    type: TechnologyType;
+    /** 版本号 */
+    version?: string;
+    /** 检测置信度 (0-1) */
+    confidence: number;
+    /** 检测来源 */
+    detectionSource: DetectionSource;
+    /** 使用程度 */
+    usage: UsageLevel;
+    /** 相关文件 */
+    relatedFiles: string[];
+    /** 技术描述 */
+    description?: string;
+}
+export type TechnologyType = "frontend-framework" | "backend-framework" | "database" | "orm" | "build-tool" | "bundler" | "testing-framework" | "linting-tool" | "deployment-tool" | "monitoring-tool" | "language" | "runtime" | "library" | "utility" | "ui-library" | "state-management" | "routing" | "styling" | "authentication" | "api-client" | "validation" | "documentation" | "ci-cd" | "containerization" | "cloud-service" | "other";
+export interface DetectionSource {
+    /** 检测方法 */
+    method: "package-json" | "import-analysis" | "config-file" | "file-extension" | "content-analysis";
+    /** 源文件路径 */
+    sourceFile: string;
+    /** 检测的具体内容 */
+    evidence: string;
+    /** 检测时间 */
+    detectedAt: string;
+}
+export type UsageLevel = "primary" | "secondary" | "development" | "minimal" | "deprecated";
+export interface TechStackCategories {
+    /** 前端技术栈 */
+    frontend: DetectedTechnology[];
+    /** 后端技术栈 */
+    backend: DetectedTechnology[];
+    /** 数据库技术 */
+    database: DetectedTechnology[];
+    /** 开发工具 */
+    devTools: DetectedTechnology[];
+    /** 部署工具 */
+    deployment: DetectedTechnology[];
+    /** 测试工具 */
+    testing: DetectedTechnology[];
+    /** 其他工具 */
+    others: DetectedTechnology[];
+}
+export interface VersionInfo {
+    /** 技术名称 */
+    technology: string;
+    /** 当前版本 */
+    currentVersion: string;
+    /** 最新版本 */
+    latestVersion?: string;
+    /** 版本状态 */
+    status: "latest" | "outdated" | "deprecated" | "unknown";
+    /** 更新建议 */
+    updateRecommendation?: string;
+    /** 破坏性变更风险 */
+    breakingChangeRisk: "low" | "medium" | "high";
+}
+export interface ConfigAnalysis {
+    /** 配置文件列表 */
+    configFiles: ConfigFile[];
+    /** 环境配置 */
+    environments: EnvironmentConfig[];
+    /** 构建配置 */
+    buildConfig: BuildConfiguration;
+    /** 部署配置 */
+    deploymentConfig?: DeploymentConfiguration;
+}
+export interface ConfigFile {
+    /** 文件路径 */
+    path: string;
+    /** 文件类型 */
+    type: "package" | "build" | "test" | "lint" | "env" | "deployment" | "other";
+    /** 文件格式 */
+    format: "json" | "yaml" | "toml" | "ini" | "js" | "ts" | "other";
+    /** 配置内容摘要 */
+    summary: string;
+    /** 重要配置项 */
+    keySettings: Record<string, any>;
+}
+export interface EnvironmentConfig {
+    /** 环境名称 */
+    name: string;
+    /** 环境类型 */
+    type: "development" | "staging" | "production" | "test";
+    /** 环境变量 */
+    variables: Record<string, string>;
+    /** 配置文件 */
+    configFiles: string[];
+}
+export interface BuildConfiguration {
+    /** 构建工具 */
+    tool: string;
+    /** 构建脚本 */
+    scripts: Record<string, string>;
+    /** 输入目录 */
+    inputDir: string;
+    /** 输出目录 */
+    outputDir: string;
+    /** 构建目标 */
+    targets: string[];
+    /** 优化配置 */
+    optimization: OptimizationConfig;
+}
+export interface OptimizationConfig {
+    /** 代码分割 */
+    codeSplitting: boolean;
+    /** 树摇优化 */
+    treeShaking: boolean;
+    /** 代码压缩 */
+    minification: boolean;
+    /** 资源压缩 */
+    compression: boolean;
+    /** 其他优化选项 */
+    others: string[];
+}
+export interface DeploymentConfiguration {
+    /** 部署平台 */
+    platform: string;
+    /** 部署类型 */
+    type: "static" | "server" | "serverless" | "container" | "hybrid";
+    /** 部署脚本 */
+    scripts: Record<string, string>;
+    /** 环境配置 */
+    environments: string[];
+    /** 部署配置文件 */
+    configFiles: string[];
+}
+export interface DetectionStats {
+    /** 总检测数量 */
+    totalDetected: number;
+    /** 各类型数量统计 */
+    byType: Record<TechnologyType, number>;
+    /** 各使用级别数量 */
+    byUsage: Record<UsageLevel, number>;
+    /** 各置信度区间数量 */
+    byConfidence: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    /** 检测耗时（毫秒） */
+    detectionTime: number;
+    /** 检测覆盖率 */
+    coverage: {
+        /** 扫描文件数 */
+        scannedFiles: number;
+        /** 总文件数 */
+        totalFiles: number;
+        /** 覆盖百分比 */
+        percentage: number;
+    };
+}
+export interface TechStackRecommendation {
+    /** 建议ID */
+    id: string;
+    /** 建议类型 */
+    type: "upgrade" | "replace" | "add" | "remove" | "configure";
+    /** 目标技术 */
+    targetTechnology: string;
+    /** 当前技术（如果适用） */
+    currentTechnology?: string;
+    /** 建议原因 */
+    reason: string;
+    /** 优先级 */
+    priority: "high" | "medium" | "low";
+    /** 影响评估 */
+    impact: ImpactAssessment;
+    /** 实施步骤 */
+    implementationSteps: string[];
+    /** 预估成本 */
+    estimatedCost: "low" | "medium" | "high";
+    /** 预期收益 */
+    expectedBenefit: string[];
+}
+export interface ImpactAssessment {
+    /** 破坏性变更风险 */
+    breakingChangeRisk: "low" | "medium" | "high";
+    /** 影响的模块 */
+    affectedModules: string[];
+    /** 需要更新的文件 */
+    filesToUpdate: string[];
+    /** 学习成本 */
+    learningCurve: "easy" | "medium" | "hard";
+    /** 社区支持 */
+    communitySupport: "excellent" | "good" | "fair" | "poor";
+    /** 迁移复杂度 */
+    migrationComplexity: "simple" | "moderate" | "complex";
+}

package/dist/requirement-analysis/types/tech-stack.js

@@ -0,0 +1 @@
+export{};