intention-coding 0.3.3 → 0.3.6

package/dist/services/code-generator/types.d.ts

@@ -0,0 +1,232 @@
+export interface WorkflowTask {
+    id: string;
+    description: string;
+    currentStage: WorkflowStage;
+    context: TaskContext;
+    stages: StageResult[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare enum WorkflowStage {
+    RESEARCH = "research",// 研究
+    IDEATION = "ideation",// 构思
+    PLANNING = "planning",// 计划
+    EXECUTION = "execution",// 执行
+    OPTIMIZATION = "optimization",// 优化
+    REVIEW = "review"
+}
+export interface TaskContext {
+    taskDescription: string;
+    projectInfo?: ProjectInfo;
+    requirements: RequirementAnalysis;
+    constraints: Constraint[];
+    successCriteria: string[];
+}
+export interface ProjectInfo {
+    name: string;
+    path: string;
+    techStack: string[];
+    frameworks: string[];
+    language: string;
+    structure: FileStructure;
+    devCommands: DevCommand[];
+}
+export interface FileStructure {
+    [path: string]: {
+        type: 'file' | 'directory';
+        content?: string;
+        children?: FileStructure;
+    };
+}
+export interface DevCommand {
+    name: string;
+    command: string;
+    description: string;
+}
+export interface RequirementAnalysis {
+    completenessScore: number;
+    targetClarity: number;
+    expectedResults: number;
+    scopeBoundary: number;
+    constraints: number;
+    missingInfo: string[];
+    clarificationQuestions: string[];
+}
+export interface Constraint {
+    type: 'time' | 'performance' | 'business' | 'technical';
+    description: string;
+    priority: 'high' | 'medium' | 'low';
+}
+export interface StageResult {
+    stage: WorkflowStage;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    input: any;
+    output: any;
+    feedback?: string;
+    timestamp: Date;
+    duration?: number;
+}
+export interface Solution {
+    id: string;
+    name: string;
+    description: string;
+    pros: string[];
+    cons: string[];
+    complexity: 'low' | 'medium' | 'high';
+    estimatedTime: string;
+    techRequirements: string[];
+    riskLevel: 'low' | 'medium' | 'high';
+    score: number;
+}
+export interface ExecutionPlan {
+    id: string;
+    solutionId: string;
+    steps: ExecutionStep[];
+    estimatedDuration: string;
+    dependencies: string[];
+    riskAssessment: string;
+    rollbackPlan: string;
+}
+export interface ExecutionStep {
+    id: string;
+    name: string;
+    description: string;
+    type: 'file_creation' | 'file_modification' | 'function_implementation' | 'class_implementation' | 'test_creation' | 'configuration';
+    targetFiles: string[];
+    atomicOperations: AtomicOperation[];
+    expectedResult: string;
+    dependencies: string[];
+    estimatedTime: string;
+}
+export interface AtomicOperation {
+    type: 'create_file' | 'modify_file' | 'create_function' | 'create_class' | 'add_import' | 'install_dependency';
+    target: string;
+    content?: string;
+    parameters?: Record<string, any>;
+}
+export interface OptimizationSuggestion {
+    id: string;
+    type: 'redundancy' | 'performance' | 'maintainability' | 'security' | 'best_practice';
+    description: string;
+    currentCode: string;
+    optimizedCode: string;
+    reason: string;
+    expectedBenefit: string;
+    impact: 'low' | 'medium' | 'high';
+    effort: 'low' | 'medium' | 'high';
+}
+export interface ReviewResult {
+    overallScore: number;
+    planAdherence: number;
+    codeQuality: number;
+    testCoverage: number;
+    documentation: number;
+    issues: Issue[];
+    recommendations: string[];
+    nextSteps: string[];
+}
+export interface Issue {
+    type: 'bug' | 'performance' | 'security' | 'maintainability' | 'documentation';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+    location: string;
+    suggestion: string;
+}
+export interface WorkflowResponse {
+    stage: WorkflowStage;
+    status: 'success' | 'error' | 'pending_approval' | 'needs_clarification';
+    message: string;
+    data?: any;
+    nextActions: string[];
+    requiresUserConfirmation: boolean;
+    clarificationQuestions?: string[];
+    executionInstructions?: AnyExecutionInstruction[];
+}
+export interface ExecutionInstruction {
+    id: string;
+    type: 'file_operation' | 'shell_command' | 'dependency_install' | 'configuration' | 'workflow_guidance';
+    description: string;
+    priority: number;
+}
+export interface FileOperationInstruction extends ExecutionInstruction {
+    type: 'file_operation';
+    operation: 'create' | 'modify' | 'delete' | 'move' | 'copy';
+    targetPath: string;
+    content?: string;
+    sourceContent?: string;
+    newContent?: string;
+    sourcePath?: string;
+}
+export interface ShellCommandInstruction extends ExecutionInstruction {
+    type: 'shell_command';
+    command: string;
+    workingDirectory?: string;
+    environment?: Record<string, string>;
+    expectedOutput?: string;
+}
+export interface DependencyInstallInstruction extends ExecutionInstruction {
+    type: 'dependency_install';
+    packageManager: 'npm' | 'yarn' | 'pnpm' | 'pip' | 'cargo';
+    packages: string[];
+    isDev?: boolean;
+}
+export interface ConfigurationInstruction extends ExecutionInstruction {
+    type: 'configuration';
+    configType: 'package.json' | 'tsconfig.json' | 'eslint' | 'prettier' | 'custom';
+    configPath: string;
+    changes: Record<string, any>;
+}
+export interface WorkflowInstruction extends ExecutionInstruction {
+    type: 'workflow_guidance';
+    stage: WorkflowStage;
+    mode: string;
+    guidance: {
+        description: string;
+        steps: string[];
+        expectedOutput: string;
+        userPrompt?: string;
+        requiresUserInput: boolean;
+        completenessCheck?: {
+            minScore: number;
+            scoringCriteria: string[];
+        };
+    };
+}
+export type AnyExecutionInstruction = FileOperationInstruction | ShellCommandInstruction | DependencyInstallInstruction | ConfigurationInstruction | WorkflowInstruction;
+export interface ExecutionResult {
+    instructionId: string;
+    status: 'success' | 'failed' | 'skipped';
+    output?: string;
+    error?: string;
+    executedAt: Date;
+}
+export interface ExecutionSummary {
+    totalInstructions: number;
+    completedInstructions: number;
+    failedInstructions: number;
+    skippedInstructions: number;
+    results: ExecutionResult[];
+    errors: Array<{
+        instructionId: string;
+        description: string;
+        error: string;
+    }>;
+}
+export declare class CodeGeneratorError extends Error {
+    readonly code: string;
+    readonly stage: WorkflowStage;
+    readonly context?: any | undefined;
+    constructor(message: string, code: string, stage: WorkflowStage, context?: any | undefined);
+}
+export declare enum ErrorCodes {
+    INVALID_TASK_DESCRIPTION = "INVALID_TASK_DESCRIPTION",
+    INCOMPLETE_REQUIREMENTS = "INCOMPLETE_REQUIREMENTS",
+    PROJECT_ANALYSIS_FAILED = "PROJECT_ANALYSIS_FAILED",
+    SOLUTION_GENERATION_FAILED = "SOLUTION_GENERATION_FAILED",
+    PLAN_CREATION_FAILED = "PLAN_CREATION_FAILED",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    OPTIMIZATION_FAILED = "OPTIMIZATION_FAILED",
+    REVIEW_FAILED = "REVIEW_FAILED",
+    USER_APPROVAL_REQUIRED = "USER_APPROVAL_REQUIRED",
+    STAGE_TRANSITION_FAILED = "STAGE_TRANSITION_FAILED"
+}

package/dist/services/code-generator/utils/instruction-executor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 执行指令处理工具
+ * 为 MCP 客户端提供指令执行的辅助方法
+ */
+import { AnyExecutionInstruction, FileOperationInstruction, ShellCommandInstruction, DependencyInstallInstruction, ConfigurationInstruction, ExecutionResult, ExecutionSummary } from '../types';
+export declare class InstructionExecutor {
+    /**
+     * 验证执行指令的有效性
+     */
+    static validateInstructions(instructions: AnyExecutionInstruction[]): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 按优先级排序指令
+     */
+    static sortInstructionsByPriority(instructions: AnyExecutionInstruction[]): AnyExecutionInstruction[];
+    /**
+     * 按类型分组指令
+     */
+    static groupInstructionsByType(instructions: AnyExecutionInstruction[]): {
+        fileOperations: FileOperationInstruction[];
+        shellCommands: ShellCommandInstruction[];
+        dependencyInstalls: DependencyInstallInstruction[];
+        configurations: ConfigurationInstruction[];
+    };
+    /**
+     * 生成执行摘要
+     */
+    static generateExecutionSummary(results: ExecutionResult[]): ExecutionSummary;
+    /**
+     * 生成执行报告
+     */
+    static generateExecutionReport(summary: ExecutionSummary): string;
+    private static validateFileOperation;
+    private static validateShellCommand;
+    private static validateDependencyInstall;
+    private static validateConfiguration;
+}
+/**
+ * 指令执行状态跟踪器
+ */
+export declare class InstructionTracker {
+    private results;
+    /**
+     * 记录指令执行结果
+     */
+    recordResult(result: ExecutionResult): void;
+    /**
+     * 获取所有结果
+     */
+    getAllResults(): ExecutionResult[];
+    /**
+     * 获取执行摘要
+     */
+    getSummary(): ExecutionSummary;
+    /**
+     * 清空结果
+     */
+    clear(): void;
+    /**
+     * 检查是否有失败的指令
+     */
+    hasFailures(): boolean;
+    /**
+     * 获取失败的指令
+     */
+    getFailures(): ExecutionResult[];
+}

package/dist/services/code-generator/workflow-manager.d.ts

@@ -0,0 +1,46 @@
+import { WorkflowTask, WorkflowStage, WorkflowResponse } from './types';
+/**
+ * 工作流程管理器
+ * 职责：管理六阶段开发工作流的执行和状态转换
+ */
+export declare class WorkflowManager {
+    private tasks;
+    private stages;
+    constructor();
+    /**
+     * 初始化各个阶段的处理器
+     */
+    private initializeStages;
+    /**
+     * 创建新的工作流任务
+     */
+    createTask(taskDescription: string): Promise<WorkflowResponse>;
+    /**
+     * 执行指定阶段
+     */
+    executeStage(taskId: string, stage: WorkflowStage, input?: any): Promise<WorkflowResponse>;
+    /**
+     * 继续到下一个阶段
+     */
+    proceedToNextStage(taskId: string, feedback?: any): Promise<WorkflowResponse>;
+    /**
+     * 跳转到指定阶段
+     */
+    jumpToStage(taskId: string, targetStage: WorkflowStage): Promise<WorkflowResponse>;
+    /**
+     * 获取任务状态
+     */
+    getTaskStatus(taskId: string): WorkflowTask;
+    /**
+     * 获取所有任务
+     */
+    getAllTasks(): WorkflowTask[];
+    /**
+     * 删除任务
+     */
+    deleteTask(taskId: string): boolean;
+    private getTask;
+    private generateTaskId;
+    private validateStageTransition;
+    private getNextStage;
+}

package/dist/services/image-analysis/analyzer.d.ts

@@ -0,0 +1,62 @@
+import { ImageAnalysisParams, AnalysisResult } from './types';
+/**
+ * 图片内容理解核心服务
+ * 职责：分析图片内容并提供智能理解
+ */
+export declare class ImageAnalyzer {
+    /**
+     * 分析图片内容
+     */
+    analyzeImage(params: ImageAnalysisParams): Promise<AnalysisResult>;
+    /**
+     * 执行AI分析
+     */
+    private performAIAnalysis;
+    /**
+     * 构建分析prompt
+     */
+    private buildAnalysisPrompt;
+    /**
+     * 获取详细程度指令
+     */
+    private getDetailInstruction;
+    /**
+     * 解析AI响应
+     */
+    private parseAIResponse;
+    /**
+     * 获取图片基本信息
+     */
+    private getImageBasicInfo;
+    /**
+     * 将图片转换为base64 data URL
+     */
+    private imageToBase64;
+    /**
+     * 验证参数
+     */
+    private validateParams;
+    /**
+     * 计算置信度分数
+     */
+    private calculateConfidenceScore;
+    private extractTags;
+    private extractObjects;
+    private extractTextContent;
+    private extractSceneInfo;
+    private extractPeopleInfo;
+    private extractTechnicalInfo;
+    private extractUIDesignInfo;
+    private extractRequirementInfo;
+    private extractValue;
+    private extractBoolean;
+    private extractList;
+    private extractUIComponents;
+    private extractColorScheme;
+    private extractTypography;
+    private extractNavigation;
+    private extractFunctionalRequirements;
+    private extractNonFunctionalRequirements;
+    private extractUserStories;
+    private formatFileSize;
+}

package/dist/services/image-analysis/index.d.ts

@@ -1,29 +1,56 @@
-import { ImageAnalysisService } from "./image-analysis";
-import { ImageValidator } from "./image-validator";
-import { ImageEncoder } from "./image-encoder";
-import { ImageAnalysisParams, ImageAnalysisResult, ImageFileInfo, ErrorCodes, ImageAnalysisError } from "./types";
-import { createImageAnalysisService, imageAnalysisService } from "./factory";
+import { z } from "zod";
+declare const ImageAnalysisParamsSchema: z.ZodObject<{
+    image_path: z.ZodString;
+    analysis_type: z.ZodEnum<{
+        text: "text";
+        general: "general";
+        objects: "objects";
+        scene: "scene";
+        people: "people";
+        technical: "technical";
+        ui_design: "ui_design";
+        requirement: "requirement";
+        custom: "custom";
+    }>;
+    custom_prompt: z.ZodOptional<z.ZodString>;
+    detail_level: z.ZodDefault<z.ZodEnum<{
+        detailed: "detailed";
+        comprehensive: "comprehensive";
+        brief: "brief";
+    }>>;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ImageAnalysisToolParams = z.infer<typeof ImageAnalysisParamsSchema>;
 /**
- * @module ImageAnalysis
- *
- * A service for analyzing images using the Moonshot Vision API.
- * This service allows you to analyze local images with custom prompts
- * using the moonshot-vision model.
- *
- * @example
- * ```typescript
- * import { imageAnalysisService } from 'src/services/image-analysis';
- *
- * const result = await imageAnalysisService.analyzeImage({
- *   imagePath: '/path/to/image.jpg',
- *   prompt: 'Describe this image',
- *   maxTokens: 4000,
- *   temperature: 0.7
- * });
- *
- * console.log(result.content);
- * ```
+ * 图片内容理解智能体
+ * 提供多种类型的图片内容分析和理解
  */
-export { ImageAnalysisService, ImageValidator, ImageEncoder, createImageAnalysisService, imageAnalysisService, };
-export { analyzeImageTool, imageAnalysisTools } from "./tools";
-export type { ImageAnalysisParams, ImageAnalysisResult, ImageFileInfo, ErrorCodes, ImageAnalysisError, };
+export declare const imageAnalysisTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        image_path: z.ZodString;
+        analysis_type: z.ZodEnum<{
+            text: "text";
+            general: "general";
+            objects: "objects";
+            scene: "scene";
+            people: "people";
+            technical: "technical";
+            ui_design: "ui_design";
+            requirement: "requirement";
+            custom: "custom";
+        }>;
+        custom_prompt: z.ZodOptional<z.ZodString>;
+        detail_level: z.ZodDefault<z.ZodEnum<{
+            detailed: "detailed";
+            comprehensive: "comprehensive";
+            brief: "brief";
+        }>>;
+        language: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    execute: (args: ImageAnalysisToolParams) => Promise<string>;
+};
+export { ImageAnalyzer } from "./analyzer";
+export type { ImageAnalysisParams, AnalysisResult, AnalysisContent, ImageBasicInfo, } from "./types";
+export { ImageAnalysisError, AnalysisErrorCodes, AnalysisType, DetailLevel, } from "./types";