soloforge 1.5.0 → 2.0.0

package/dist/types/state_machine.d.ts

@@ -0,0 +1,353 @@
+/**
+ * 状态机驱动路由 — 核心类型定义。
+ *
+ * Phase 1 新增类型，与现有类型系统完全独立。
+ * 所有新状态机模块仅依赖此文件中的类型和映射常量。
+ */
+import type { TaskStage, ExecutableWorkPackage } from "../engine/workflow/workflow_navigation_contract.js";
+import type { SystemType } from "./base.js";
+import type { DiagnosticReport } from "../engine/pipeline/state_machine/state_self_diagnostic.js";
+/** 管线状态 — 持久化为 YAML 文件 */
+export interface PipelineState {
+    version: "1.0";
+    pipeline_id: string;
+    system_type: SystemType;
+    description: string;
+    current_stage: TaskStage;
+    stages: PipelineStageEntry[];
+    lock: PipelineLock;
+    /** 产出文件哈希（阶段ID → 文件哈希） */
+    output_hashes: Record<string, string>;
+    /** 回退历史记录 */
+    rollback_history: RollbackHistoryEntry[];
+    /** 审计日志（内嵌） */
+    audit_log: AuditLogEntry[];
+}
+/** 单阶段条目 */
+export interface PipelineStageEntry {
+    stage: TaskStage;
+    status: PipelineStageStatus;
+    started_at: string | null;
+    completed_at: string | null;
+    outputs: string[];
+}
+export type PipelineStageStatus = "pending" | "in_progress" | "completed" | "skipped";
+/** 乐观锁 */
+export interface PipelineLock {
+    version: number;
+    locked_at: string;
+}
+/** 回退历史条目 */
+export interface RollbackHistoryEntry {
+    from: TaskStage;
+    to: TaskStage;
+    reason: string;
+    at: string;
+}
+/** 审计日志条目 */
+export interface AuditLogEntry {
+    timestamp: string;
+    operation: string;
+    from_stage?: TaskStage;
+    to_stage?: TaskStage;
+    user_confirmation?: string;
+    previous_snapshot_path?: string;
+    reason?: string;
+}
+/** 三级确定性门禁结果 */
+export interface CertaintyGateResult {
+    /** 第一级：输入完备性（知识覆盖 + 必需输入） */
+    level1: {
+        passed: boolean;
+        knowledge_hits: number;
+        min_required: number;
+        missing_inputs: string[];
+    };
+    /** 第二级：方案风险扫描（风险模式 + mini-brainstorm 触发） */
+    level2: {
+        passed: boolean;
+        risk_patterns_hit: string[];
+        brainstorm_required: boolean;
+        brainstorm_template: BrainstormTemplate | null;
+        first_principles_required: boolean;
+        /** FP 规则命中列表（如 FP-01, FP-03） */
+        fp_rules_triggered?: string[];
+    };
+    /** 第三级：决策确认（人类确认级别） */
+    level3: {
+        passed: boolean;
+        confirmation_level: ConfirmationLevel;
+        pending_confirmations: string[];
+    };
+    overall_passed: boolean;
+    block_reason?: string;
+    /** 扁平检查项列表 */
+    checks: GateCheckItem[];
+    /** 置信度得分（由 confidence_scorer 评估，范围 0~1） */
+    confidence_score?: number;
+}
+export type ConfirmationLevel = "must_confirm" | "should_confirm" | "auto_resolvable";
+/** 门禁检查项 */
+export interface GateCheckItem {
+    /** 检查 ID */
+    check_id: string;
+    /** 中文名称 */
+    name_zh: string;
+    /** 是否通过 */
+    passed: boolean;
+    /** 证据描述 */
+    evidence: string;
+    /** 阻断原因 */
+    blocking_reason?: string;
+    /** 修复建议 */
+    fix_suggestion?: string;
+}
+/** mini-brainstorm 模板（第二级门禁触发时提供） */
+export interface BrainstormTemplate {
+    option_a: string;
+    option_b: string;
+    default_strategy: string;
+    risk_pattern_id: RiskPatternId;
+    /** 优点列表 */
+    pros: string[];
+    /** 缺点列表 */
+    cons: string[];
+    /** 失败条件 */
+    failure_conditions: string[];
+    /** 验证方法 */
+    verification_method: string;
+    /** 知识资产引用路径（如头脑风暴流程模板） */
+    knowledge_asset_ref?: string;
+}
+/** 风险模式 ID */
+export type RiskPatternId = "ddl_change" | "permission_change" | "amount_logic" | "cross_system" | "state_transition" | "destructive" | "concurrency" | "sensitive_data";
+/** 风险模式匹配结果 */
+export interface RiskPatternMatch {
+    pattern_id: RiskPatternId;
+    description_zh: string;
+    severity: RiskPatternSeverity;
+    matched_keywords: string[];
+    default_strategy_zh: string;
+}
+export type RiskPatternSeverity = "hard_fail" | "warning";
+/** 解析后的 [sf] 命令 */
+export interface ParsedCommand {
+    /** 动词：init / start / advance / rollback / gate_check / status / diagnose / repair / jump / reset / archive / unknown */
+    verb: ParsedVerb;
+    /** 目标阶段（可选） */
+    stage?: TaskStage;
+    /** 阶段内子动作（可选） */
+    action?: string;
+    /** 工作描述 */
+    description: string;
+    /** 原始文本 */
+    raw_text: string;
+    /** 跳转目标阶段（仅 jump 操作） */
+    target_stage?: TaskStage;
+    /** 强确认文本（仅 jump / reset 操作） */
+    confirmation_text?: string;
+    /** 切片编号（仅切片相关命令） */
+    slice_number?: number;
+}
+export type ParsedVerb = "init" | "start" | "advance" | "rollback" | "gate_check" | "status" | "brainstorm" | "first_principles" | "reasoning_log" | "diagnose" | "repair" | "jump" | "reset" | "archive" | "direct_answer" | "single_artifact" | "unknown";
+/** sf_stage_execute 返回结果 */
+export interface StageExecuteResult {
+    task_id: string | null;
+    pipeline_id: string;
+    stage: TaskStage;
+    action: string;
+    status: PipelineStageStatus;
+    outputs: string[];
+    knowledge_hit_count: number;
+    gate_result: CertaintyGateResult | null;
+    next_actions: string[];
+    /** 委托工具提示（Phase 2 使用） */
+    delegate_hint: DelegateHint | null;
+    /** 被阻断标志（隐私门禁/风险模式等） */
+    blocked?: boolean;
+    /** 阻断原因 */
+    block_reason?: string;
+    /** 自诊断报告 */
+    diagnostic_report?: DiagnosticReport;
+    /** 头脑风暴触发信息 */
+    brainstorm_trigger?: {
+        reason: string;
+        suggestion: string;
+    } | null;
+    /** 第一性原理触发信息 */
+    first_principles_trigger?: {
+        reason: string;
+        suggestion: string;
+    } | null;
+    /** 自动回退建议 */
+    auto_rollback_suggestion?: {
+        target: TaskStage;
+        reason: string;
+    } | null;
+    /** 切片上下文 */
+    slice_context?: unknown;
+    /** 覆盖率报告 */
+    coverage_report?: {
+        passed: boolean;
+        percentage: number;
+        details: string;
+    } | null;
+    /** 确认要求（强确认机制） */
+    required_confirmation?: string;
+    /** 知识注入审计报告 */
+    injection_report?: {
+        total: number;
+        hard_fail_count: number;
+        injected: string[];
+        skipped: string[];
+    };
+    /** 项目知识命中统计 */
+    project_knowledge?: {
+        total: number;
+        hard_fail_count: number;
+        soft_warning_count: number;
+    };
+    /** 架构设计阶段决策门控结果（仅架构设计阶段返回） */
+    architecture_decision_gate?: {
+        allowed: boolean;
+        reason_zh: string;
+        validation: {
+            valid: boolean;
+            violations: string[];
+            warnings: string[];
+        };
+        execution: {
+            allowed: boolean;
+            requires_human_gate: boolean;
+            executable_without_human: boolean;
+            reason: string;
+        };
+    };
+    /** 上下文引擎分析结果（context_engine 视图 summary） */
+    context_analysis?: string;
+    /** 执行规则与门禁注入文本（companion_injector 产出） */
+    companion_injection?: string;
+}
+/** 委托工具提示 */
+export interface DelegateHint {
+    tool_name: string;
+    args: Record<string, unknown>;
+}
+/** sf_stage_advance 返回结果 */
+export interface StageAdvanceResult {
+    pipeline_id: string;
+    from_stage: TaskStage;
+    to_stage: TaskStage;
+    gate_passed: boolean;
+    gate_result: CertaintyGateResult | null;
+}
+/** sf_stage_rollback 返回结果 */
+export interface StageRollbackResult {
+    pipeline_id: string;
+    from_stage: TaskStage;
+    to_stage: TaskStage;
+    stale_outputs: string[];
+    skipped_stages: TaskStage[];
+    /** 操作前上下文快照路径 */
+    context_snapshot?: string;
+    /** 被跳过阶段丢失的产出 */
+    lost_outputs?: string[];
+    /** 回退后指令 */
+    directive?: string;
+}
+/** sf_pipeline_init 返回结果 */
+export interface PipelineInitResult {
+    pipeline_id: string;
+    system_type: SystemType;
+    initial_stage: TaskStage;
+    stage_count: number;
+    /** 初始可用动作 */
+    available_actions: NextAvailableAction[];
+    /** 必需输入列表 */
+    required_inputs: string[];
+}
+/** 阶段可用动作 */
+export interface StageAction {
+    action_id: string;
+    name_zh: string;
+    description_zh: string;
+    delegate_tool: string | null;
+    mutation_allowed: boolean;
+}
+/**
+ * ALLOWED_MUTATION_STAGES — 允许修改源码的阶段。
+ * 用途：check-write Hook、scope 控制。
+ */
+export declare const ALLOWED_MUTATION_STAGES: ReadonlySet<TaskStage>;
+/**
+ * STAGE_WORKFLOW_MAP — 阶段到旧 WorkflowIntent 的映射。
+ * 用途：resolveWorkflowInfo 管线查询。
+ */
+export declare const STAGE_WORKFLOW_MAP: Record<TaskStage, string>;
+/**
+ * STAGE_ACTION_MAP — 每阶段可用动作 ID 列表。
+ * 用途：阶段执行时列举可用动作。
+ * 从 stage_command_registry.ts 提取。
+ */
+export declare const STAGE_ACTION_MAP: Record<TaskStage, string[]>;
+/** sf_next 返回的可用动作项 */
+export interface NextAvailableAction {
+    action: string;
+    description_zh: string;
+    tool: string;
+    params?: Record<string, unknown>;
+}
+/** sf_next 返回的阻断项 */
+export interface NextBlockingItem {
+    reason: string;
+    resolution_command: string;
+}
+/** sf_next 返回的确认项 */
+export interface NextConfirmationItem {
+    level: "must_confirm" | "should_confirm" | "auto_resolvable";
+    item: string;
+    resolved: boolean;
+}
+/** sf_next 返回结果 */
+export interface NextResult {
+    pipeline_type: string | null;
+    pipeline_active: boolean;
+    project_stage: string;
+    current_task_stage: TaskStage | null;
+    stage_status: "not_started" | "in_progress" | "gate_blocked" | "completed";
+    progress_percent: number;
+    available_actions: NextAvailableAction[];
+    blocking_items: NextBlockingItem[];
+    confirmations: NextConfirmationItem[];
+    work_package: ExecutableWorkPackage | null;
+}
+/** sf_pipeline_status 返回的阶段详情 */
+export interface PipelineStatusStage {
+    stage: TaskStage;
+    status: "pending" | "skipped" | "in_progress" | "gate_blocked" | "completed";
+    started_at?: string;
+    completed_at?: string;
+    outputs: string[];
+    gate_result?: {
+        passed: boolean;
+        details: string;
+    };
+    force_completed?: boolean;
+}
+/** sf_pipeline_status 返回的回退历史条目 */
+export interface PipelineStatusRollbackEntry {
+    from: TaskStage;
+    to: TaskStage;
+    reason: string;
+    at: string;
+}
+/** sf_pipeline_status 返回结果 */
+export interface PipelineStatusResult {
+    pipeline_type: string;
+    system_type: "new_system" | "existing_system";
+    stages: PipelineStatusStage[];
+    current_stage_index: number;
+    progress_percent: number;
+    rollback_history: PipelineStatusRollbackEntry[];
+}
+//# sourceMappingURL=state_machine.d.ts.map

package/dist/types/state_machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../../src/types/state_machine.ts"],"names":[],"mappings":"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"}

package/dist/types/state_machine.js

@@ -0,0 +1,47 @@
+/**
+ * 状态机驱动路由 — 核心类型定义。
+ *
+ * Phase 1 新增类型，与现有类型系统完全独立。
+ * 所有新状态机模块仅依赖此文件中的类型和映射常量。
+ */
+// ═══════════════════════════════════════════
+// 5 个映射常量（设计文档 16.6 节）
+// ═══════════════════════════════════════════
+/**
+ * ALLOWED_MUTATION_STAGES — 允许修改源码的阶段。
+ * 用途：check-write Hook、scope 控制。
+ */
+export const ALLOWED_MUTATION_STAGES = new Set([
+    "编码与单元测试",
+    "代码审查",
+]);
+/**
+ * STAGE_WORKFLOW_MAP — 阶段到旧 WorkflowIntent 的映射。
+ * 用途：resolveWorkflowInfo 管线查询。
+ */
+export const STAGE_WORKFLOW_MAP = {
+    "需求分析": "wf-requirements-analysis",
+    "现有系统分析": "wf-existing-system-gap-analysis",
+    "架构设计": "wf-architecture-design",
+    "详细设计": "wf-detail-design",
+    "任务规划": "wf-task-planning",
+    "编码与单元测试": "wf-test-first-coding",
+    "代码审查": "wf-code-review",
+    "联调验证": "wf-integration-verification",
+};
+/**
+ * STAGE_ACTION_MAP — 每阶段可用动作 ID 列表。
+ * 用途：阶段执行时列举可用动作。
+ * 从 stage_command_registry.ts 提取。
+ */
+export const STAGE_ACTION_MAP = {
+    "需求分析": ["collect_requirements"],
+    "现有系统分析": ["analyze_existing"],
+    "架构设计": ["design_architecture", "confirm_decisions", "brainstorm", "first_principles"],
+    "详细设计": ["execute", "execute_db", "execute_api"],
+    "任务规划": ["execute"],
+    "编码与单元测试": ["start_slice", "complete_slice", "check_coverage", "execute"],
+    "代码审查": ["execute"],
+    "联调验证": ["execute", "run_e2e", "run_trial", "upload_logs"],
+};
+//# sourceMappingURL=state_machine.js.map

package/dist/types/state_machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine.js","sourceRoot":"","sources":["../../src/types/state_machine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwTH,8CAA8C;AAC9C,uBAAuB;AACvB,8CAA8C;AAG9C;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA2B,IAAI,GAAG,CAAY;IAChF,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,MAAM,EAAE,0BAA0B;IAClC,QAAQ,EAAE,iCAAiC;IAC3C,MAAM,EAAE,wBAAwB;IAChC,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,6BAA6B;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,MAAM,EAAE,CAAC,sBAAsB,CAAC;IAChC,QAAQ,EAAE,CAAC,kBAAkB,CAAC;IAC9B,MAAM,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,CAAC;IACtF,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC;IAChD,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,CAAC;IACzE,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC;CAC3D,CAAC"}