@nick848/sf-cli 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1375,9 +1375,258 @@ interface REPLState {
     contextLimit: number;
 }
 
+/**
+ * 工作流确认点系统
+ * 在关键节点要求开发者确认才能继续
+ */
+
+/**
+ * 确认点类型
+ */
+type ConfirmationPointType = 'spec-review' | 'architecture' | 'code-review';
+/**
+ * 确认点定义
+ */
+interface ConfirmationPoint {
+    type: ConfirmationPointType;
+    name: string;
+    description: string;
+    triggerStep: WorkflowStep;
+    targetStep: WorkflowStep;
+    required: boolean;
+    timeout?: number;
+}
+/**
+ * 确认状态
+ */
+interface ConfirmationStatus {
+    type: ConfirmationPointType;
+    confirmed: boolean;
+    confirmedAt?: Date;
+    confirmedBy?: string;
+    comment?: string;
+}
+/**
+ * 回滚规则
+ * 定义从哪些阶段可以回滚到哪些阶段
+ *
+ * 复杂流程: explore → new → continue → apply → archive
+ * 简单流程: propose → apply → archive
+ */
+declare const ROLLBACK_RULES: Record<WorkflowStep, WorkflowStep[]>;
+/**
+ * 回滚原因类型
+ */
+type RollbackReason = 'code-review-failed' | 'requirement-changed' | 'design-issue' | 'user-request';
+/**
+ * 回滚请求
+ */
+interface RollbackRequest {
+    fromStep: WorkflowStep;
+    toStep: WorkflowStep;
+    reason: RollbackReason;
+    description: string;
+    timestamp: Date;
+}
+/**
+ * 确认点管理器
+ */
+declare class ConfirmationManager {
+    private confirmationPoints;
+    private confirmations;
+    constructor(customPoints?: ConfirmationPoint[]);
+    /**
+     * 获取指定阶段的确认点
+     */
+    getConfirmationPointForTransition(from: WorkflowStep, to: WorkflowStep): ConfirmationPoint | undefined;
+    /**
+     * 检查是否需要确认
+     */
+    needsConfirmation(from: WorkflowStep, to: WorkflowStep): boolean;
+    /**
+     * 获取确认点详情
+     */
+    getConfirmationPoint(type: ConfirmationPointType): ConfirmationPoint | undefined;
+    /**
+     * 记录确认
+     */
+    confirm(type: ConfirmationPointType, comment?: string): ConfirmationStatus;
+    /**
+     * 获取确认状态
+     */
+    getConfirmationStatus(type: ConfirmationPointType): ConfirmationStatus | undefined;
+    /**
+     * 检查确认点是否已确认
+     */
+    isConfirmed(type: ConfirmationPointType): boolean;
+    /**
+     * 清除确认状态（用于回滚后）
+     */
+    clearConfirmation(type: ConfirmationPointType): void;
+    /**
+     * 清除所有确认状态
+     */
+    clearAllConfirmations(): void;
+    /**
+     * 获取所有确认点
+     */
+    getAllConfirmationPoints(): ConfirmationPoint[];
+    /**
+     * 获取指定阶段需要清除的确认点
+     */
+    getConfirmationsToClear(targetStep: WorkflowStep): ConfirmationPointType[];
+}
+/**
+ * 生成确认提示消息
+ */
+declare function generateConfirmationPrompt(point: ConfirmationPoint): string;
+/**
+ * 生成回滚选项提示
+ */
+declare function generateRollbackPrompt(fromStep: WorkflowStep): string;
+
+/**
+ * OpenSpec 工作流引擎
+ * 管理工作流状态、状态转换、确认点、回滚
+ */
+
+interface WorkflowSnapshot {
+    step: WorkflowStep;
+    timestamp: Date;
+    state: WorkflowState;
+    artifacts: string[];
+}
+interface RollbackResult {
+    success: boolean;
+    from: WorkflowStep;
+    to: WorkflowStep | null;
+    message: string;
+    snapshot?: WorkflowSnapshot;
+}
+interface ConfirmationResult {
+    required: boolean;
+    confirmed: boolean;
+    point?: ConfirmationPoint;
+}
+declare class WorkflowEngine {
+    private state;
+    private projectPath;
+    private openspecPath;
+    private confirmationManager;
+    private snapshots;
+    private projectContext;
+    private projectConfig;
+    private devStandards;
+    constructor();
+    /**
+     * 初始化工作流引擎
+     */
+    initialize(projectPath: string): Promise<void>;
+    /**
+     * 加载项目上下文（AGENTS.md 和 config.yaml）
+     */
+    private loadProjectContext;
+    /**
+     * 获取项目上下文
+     */
+    getProjectContext(): {
+        agentsMd: string;
+        configYaml: string;
+        devStandards: string;
+    };
+    /**
+     * 启动新工作流
+     */
+    start(requirement: string, complexity: number, options?: {
+        title?: string;
+    }): Promise<WorkflowState>;
+    /**
+     * 检查转换是否需要确认
+     */
+    checkConfirmationNeeded(from: WorkflowStep, to: WorkflowStep): ConfirmationResult;
+    /**
+     * 确认检查点
+     */
+    confirm(type: ConfirmationPointType, comment?: string): void;
+    /**
+     * 获取确认点信息
+     */
+    getConfirmationPoint(type: ConfirmationPointType): ConfirmationPoint | undefined;
+    /**
+     * 获取当前转换需要的确认点
+     */
+    getCurrentConfirmationPoint(): ConfirmationPoint | undefined;
+    /**
+     * 执行状态转换
+     */
+    transition(targetStep: WorkflowStep, reason?: string): Promise<WorkflowTransition>;
+    /**
+     * 获取可回滚的目标阶段
+     */
+    getRollbackTargets(): WorkflowStep[];
+    /**
+     * 检查是否可以回滚到指定阶段
+     */
+    canRollbackTo(targetStep: WorkflowStep): boolean;
+    /**
+     * 执行回滚
+     */
+    rollback(targetStep: WorkflowStep, reason: RollbackReason, description?: string): Promise<RollbackResult>;
+    /**
+     * 获取回滚原因描述
+     */
+    getRollbackReasonDescription(reason: RollbackReason): string;
+    /**
+     * 获取当前状态
+     */
+    getState(): WorkflowState | null;
+    /**
+     * 获取允许的下一步
+     */
+    getAllowedTransitions(): WorkflowStep[];
+    /**
+     * 获取快照历史
+     */
+    getSnapshots(): WorkflowSnapshot[];
+    /**
+     * 完成当前步骤
+     */
+    completeCurrentStep(artifacts?: string[]): Promise<void>;
+    /**
+     * 归档工作流
+     */
+    archive(summary: string): Promise<void>;
+    /**
+     * 取消工作流
+     */
+    cancel(reason: string): Promise<void>;
+    private ensureDirectories;
+    private restoreState;
+    private saveState;
+    private restoreSnapshots;
+    private saveSnapshots;
+    private createSnapshot;
+    private generateChangeId;
+    private createChangeRecord;
+    private updateChangeRecord;
+    private formatChangeRecord;
+    private createSpecDocument;
+}
+/**
+ * 确认点需要确认错误
+ */
+declare class ConfirmationRequiredError extends Error {
+    readonly point: ConfirmationPoint;
+    constructor(message: string, point: ConfirmationPoint);
+}
+
 /**
  * 命令执行器
  * 执行解析后的命令
+ *
+ * 强制工作流机制：
+ * - 没有活跃工作流时，只允许基础命令（/help, /init, /model, /new, /exit, /clear, /update, /version）
+ * - 有活跃工作流时，根据当前阶段限制操作
  */
 
 interface ExecutorContext {
@@ -1385,6 +1634,7 @@ interface ExecutorContext {
     configManager: ConfigManager;
     modelService: ModelService;
     normsManager?: NormsManager;
+    workflowEngine?: WorkflowEngine;
     state: REPLState;
     options: {
         workingDirectory: string;
@@ -1399,6 +1649,10 @@ interface ExecutionResult {
 }
 declare class CommandExecutor {
     execute(parseResult: ParseResult, ctx: ExecutorContext): Promise<ExecutionResult>;
+    /**
+     * 检查工作流权限
+     */
+    private checkWorkflowPermission;
     private executeSlashCommand;
     private executeFileReference;
     private executeAgent;
@@ -1644,251 +1898,6 @@ declare function createAgentScheduler(executor: AgentExecutor): AgentScheduler;
  */
 declare function getScheduleRuleDescription(step: WorkflowStep): string;
 
-/**
- * 工作流确认点系统
- * 在关键节点要求开发者确认才能继续
- */
-
-/**
- * 确认点类型
- */
-type ConfirmationPointType = 'spec-review' | 'architecture' | 'code-review';
-/**
- * 确认点定义
- */
-interface ConfirmationPoint {
-    type: ConfirmationPointType;
-    name: string;
-    description: string;
-    triggerStep: WorkflowStep;
-    targetStep: WorkflowStep;
-    required: boolean;
-    timeout?: number;
-}
-/**
- * 确认状态
- */
-interface ConfirmationStatus {
-    type: ConfirmationPointType;
-    confirmed: boolean;
-    confirmedAt?: Date;
-    confirmedBy?: string;
-    comment?: string;
-}
-/**
- * 回滚规则
- * 定义从哪些阶段可以回滚到哪些阶段
- *
- * 复杂流程: explore → new → continue → apply → archive
- * 简单流程: propose → apply → archive
- */
-declare const ROLLBACK_RULES: Record<WorkflowStep, WorkflowStep[]>;
-/**
- * 回滚原因类型
- */
-type RollbackReason = 'code-review-failed' | 'requirement-changed' | 'design-issue' | 'user-request';
-/**
- * 回滚请求
- */
-interface RollbackRequest {
-    fromStep: WorkflowStep;
-    toStep: WorkflowStep;
-    reason: RollbackReason;
-    description: string;
-    timestamp: Date;
-}
-/**
- * 确认点管理器
- */
-declare class ConfirmationManager {
-    private confirmationPoints;
-    private confirmations;
-    constructor(customPoints?: ConfirmationPoint[]);
-    /**
-     * 获取指定阶段的确认点
-     */
-    getConfirmationPointForTransition(from: WorkflowStep, to: WorkflowStep): ConfirmationPoint | undefined;
-    /**
-     * 检查是否需要确认
-     */
-    needsConfirmation(from: WorkflowStep, to: WorkflowStep): boolean;
-    /**
-     * 获取确认点详情
-     */
-    getConfirmationPoint(type: ConfirmationPointType): ConfirmationPoint | undefined;
-    /**
-     * 记录确认
-     */
-    confirm(type: ConfirmationPointType, comment?: string): ConfirmationStatus;
-    /**
-     * 获取确认状态
-     */
-    getConfirmationStatus(type: ConfirmationPointType): ConfirmationStatus | undefined;
-    /**
-     * 检查确认点是否已确认
-     */
-    isConfirmed(type: ConfirmationPointType): boolean;
-    /**
-     * 清除确认状态（用于回滚后）
-     */
-    clearConfirmation(type: ConfirmationPointType): void;
-    /**
-     * 清除所有确认状态
-     */
-    clearAllConfirmations(): void;
-    /**
-     * 获取所有确认点
-     */
-    getAllConfirmationPoints(): ConfirmationPoint[];
-    /**
-     * 获取指定阶段需要清除的确认点
-     */
-    getConfirmationsToClear(targetStep: WorkflowStep): ConfirmationPointType[];
-}
-/**
- * 生成确认提示消息
- */
-declare function generateConfirmationPrompt(point: ConfirmationPoint): string;
-/**
- * 生成回滚选项提示
- */
-declare function generateRollbackPrompt(fromStep: WorkflowStep): string;
-
-/**
- * OpenSpec 工作流引擎
- * 管理工作流状态、状态转换、确认点、回滚
- */
-
-interface WorkflowSnapshot {
-    step: WorkflowStep;
-    timestamp: Date;
-    state: WorkflowState;
-    artifacts: string[];
-}
-interface RollbackResult {
-    success: boolean;
-    from: WorkflowStep;
-    to: WorkflowStep | null;
-    message: string;
-    snapshot?: WorkflowSnapshot;
-}
-interface ConfirmationResult {
-    required: boolean;
-    confirmed: boolean;
-    point?: ConfirmationPoint;
-}
-declare class WorkflowEngine {
-    private state;
-    private projectPath;
-    private openspecPath;
-    private confirmationManager;
-    private snapshots;
-    private projectContext;
-    private projectConfig;
-    private devStandards;
-    constructor();
-    /**
-     * 初始化工作流引擎
-     */
-    initialize(projectPath: string): Promise<void>;
-    /**
-     * 加载项目上下文（AGENTS.md 和 config.yaml）
-     */
-    private loadProjectContext;
-    /**
-     * 获取项目上下文
-     */
-    getProjectContext(): {
-        agentsMd: string;
-        configYaml: string;
-        devStandards: string;
-    };
-    /**
-     * 启动新工作流
-     */
-    start(requirement: string, complexity: number, options?: {
-        title?: string;
-    }): Promise<WorkflowState>;
-    /**
-     * 检查转换是否需要确认
-     */
-    checkConfirmationNeeded(from: WorkflowStep, to: WorkflowStep): ConfirmationResult;
-    /**
-     * 确认检查点
-     */
-    confirm(type: ConfirmationPointType, comment?: string): void;
-    /**
-     * 获取确认点信息
-     */
-    getConfirmationPoint(type: ConfirmationPointType): ConfirmationPoint | undefined;
-    /**
-     * 获取当前转换需要的确认点
-     */
-    getCurrentConfirmationPoint(): ConfirmationPoint | undefined;
-    /**
-     * 执行状态转换
-     */
-    transition(targetStep: WorkflowStep, reason?: string): Promise<WorkflowTransition>;
-    /**
-     * 获取可回滚的目标阶段
-     */
-    getRollbackTargets(): WorkflowStep[];
-    /**
-     * 检查是否可以回滚到指定阶段
-     */
-    canRollbackTo(targetStep: WorkflowStep): boolean;
-    /**
-     * 执行回滚
-     */
-    rollback(targetStep: WorkflowStep, reason: RollbackReason, description?: string): Promise<RollbackResult>;
-    /**
-     * 获取回滚原因描述
-     */
-    getRollbackReasonDescription(reason: RollbackReason): string;
-    /**
-     * 获取当前状态
-     */
-    getState(): WorkflowState | null;
-    /**
-     * 获取允许的下一步
-     */
-    getAllowedTransitions(): WorkflowStep[];
-    /**
-     * 获取快照历史
-     */
-    getSnapshots(): WorkflowSnapshot[];
-    /**
-     * 完成当前步骤
-     */
-    completeCurrentStep(artifacts?: string[]): Promise<void>;
-    /**
-     * 归档工作流
-     */
-    archive(summary: string): Promise<void>;
-    /**
-     * 取消工作流
-     */
-    cancel(reason: string): Promise<void>;
-    private ensureDirectories;
-    private restoreState;
-    private saveState;
-    private restoreSnapshots;
-    private saveSnapshots;
-    private createSnapshot;
-    private generateChangeId;
-    private createChangeRecord;
-    private updateChangeRecord;
-    private formatChangeRecord;
-    private createSpecDocument;
-}
-/**
- * 确认点需要确认错误
- */
-declare class ConfirmationRequiredError extends Error {
-    readonly point: ConfirmationPoint;
-    constructor(message: string, point: ConfirmationPoint);
-}
-
 /**
  * 自动补全器
  * 提供命令、文件路径、历史记录的自动补全