soloforge 1.1.40 → 1.1.42

package/dist/engine/pipeline/orchestrate_single_artifact.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 四层编排共享内核 — 单产物操作的统一编排函数。
+ *
+ * 三种场景共用此内核：
+ * - 场景 A：sf_command（[sf] 审查/修改/生成/迭代 某某产物）
+ * - 场景 B：sf_single_artifact（结构化参数快捷入口）
+ * - 场景 C：CLI review/modify 命令
+ *
+ * 四层编排：
+ *   Layer 1 — 模板层：从模板 frontmatter 读取 companion_rules / companion_gates / consumes
+ *   Layer 2 — 引擎层：解析 consumes → 加载上游产物内容
+ *   Layer 3 — 上下文引擎：运行 requires_context 视图
+ *   Layer 4 — 规则层 + 门禁层：injectCompanions 按 operation 过滤加载
+ *   Layer 5 — 范围约束：allowed_paths + read_only_paths
+ *
+ * 按方案 SoloForge-模板体系四层职责分离方案.md Section 2.4 实现。
+ */
+import type { OperationType } from "../../types/pipeline.js";
+import type { ArtifactKind } from "../contracts/artifact_contract_registry.js";
+/** 内核输入参数 */
+export interface OrchestrateParams {
+    /** 产物类型（ArtifactKind） */
+    kind: ArtifactKind;
+    /** 操作类型 */
+    operation: OperationType;
+    /** 项目根路径 */
+    projectPath: string;
+    /** 原始命令文本（用于 missing_upstream 时引导回原任务） */
+    original_command?: string;
+    /** 管线类型（新系统/老系统），用于模板搜索路径和产物过滤 */
+    systemType?: "新系统" | "老系统";
+}
+/** 上游输入项 */
+export interface UpstreamInput {
+    ref: string;
+    resolved_kind?: string;
+    paths: string[];
+    contents: Record<string, string>;
+    missing: boolean;
+}
+/** 内核输出 */
+export interface OrchestrateResult {
+    mode: "single_artifact";
+    status: "ready" | "no_template" | "missing_upstream" | "need_target_info" | "error";
+    target_kind: ArtifactKind;
+    target_name: string;
+    target_paths: string[];
+    /** 首次创建时的建议路径（含通配符 pattern） */
+    suggested_target_paths?: string[];
+    template_name?: string;
+    template_body?: string;
+    upstream_inputs?: UpstreamInput[];
+    missing_inputs?: MissingInput[];
+    available_inputs?: AvailableInput[];
+    suggested_action?: {
+        produce_first: string;
+        then_resume: string;
+    };
+    context_analysis?: string;
+    rules?: Array<{
+        name: string;
+        usage: string;
+        content: string;
+    }>;
+    missing_rules?: string[];
+    gates?: Array<{
+        name: string;
+        content: string;
+    }>;
+    missing_gates?: string[];
+    injection_text?: string;
+    scope?: {
+        allowed_paths: string[];
+        read_only_paths: string[];
+    };
+    original_task?: {
+        kind: ArtifactKind;
+        description: string;
+        command: string;
+    };
+    error?: string;
+    operation?: OperationType;
+}
+/** 缺失输入项（用于 missing_upstream 状态） */
+export interface MissingInput {
+    ref: string;
+    kind?: string;
+    template_name?: string;
+    template_path?: string | null;
+    available_upstream: AvailableInput[];
+    message: string;
+}
+/** 可用输入项 */
+export interface AvailableInput {
+    ref: string;
+    kind?: string;
+    paths: string[];
+    missing: boolean;
+}
+/**
+ * 为 iterate 操作构建自动迭代循环指令。
+ *
+ * 核心流程：review → 发现问题 → fix → 再 review → 直到全部通过。
+ * 这不是内核的自动化循环（内核不运行 AI），而是在 injection_text 中
+ * 告诉 AI 遵循的迭代协议。
+ */
+export declare function buildIterateDirective(operation: OperationType, targetName: string, targetPaths: string[], gateNames: string[]): string;
+/**
+ * 构建 extract 操作的质量纪律指令。
+ *
+ * extract 是首次创建产物，无迭代循环也无上游对比。
+ * 此函数注入创建质量纪律，防止 AI 产出空洞内容。
+ */
+export declare function buildExtractQualityDirective(operation: OperationType, targetName: string, targetPaths: string[], gateNames: string[]): string;
+/**
+ * 四层编排共享内核 — 单产物操作统一入口。
+ *
+ * @param params.kind - 产物类型（ArtifactKind）
+ * @param params.operation - 操作类型（extract/review/fix/iterate）
+ * @param params.projectPath - 项目根路径
+ * @returns 编排结果（OrchestrateResult）
+ */
+export declare function orchestrateSingleArtifact(params: OrchestrateParams): Promise<OrchestrateResult>;
+/** 阶段级审查参数 */
+export interface StageReviewParams {
+    /** 阶段名称（TaskStage） */
+    stage: string;
+    /** 项目根路径 */
+    projectPath: string;
+    /** 原始命令文本 */
+    original_command?: string;
+    /** 管线类型（新系统/老系统），用于产物过滤 */
+    systemType?: "新系统" | "老系统";
+}
+/** 阶段级审查中每个产物的编排摘要 */
+export interface StageArtifactResult {
+    kind: ArtifactKind;
+    name: string;
+    paths: string[];
+    status: "ready" | "missing_upstream" | "no_template" | "missing_target";
+    injection_text?: string;
+    upstream_inputs?: UpstreamInput[];
+    template_body?: string;
+    rules?: Array<{
+        name: string;
+        usage: string;
+        content: string;
+    }>;
+    gates?: Array<{
+        name: string;
+        content: string;
+    }>;
+    missing_inputs?: MissingInput[];
+    error?: string;
+}
+/** 阶段级审查结果 */
+export interface StageReviewResult {
+    mode: "stage_review";
+    status: "ready" | "partial" | "no_artifacts" | "error";
+    stage: string;
+    /** 每个产物的编排结果 */
+    artifact_results: StageArtifactResult[];
+    /** 聚合后的阶段级审查指令 */
+    injection_text: string;
+    /** 聚合的 scope 约束 */
+    scope?: {
+        allowed_paths: string[];
+        read_only_paths: string[];
+    };
+    /** 错误信息 */
+    error?: string;
+}
+/** 构建阶段级审查 injection_text */
+export declare function buildStageReviewInjection(stage: string, results: StageArtifactResult[], gates: Array<{
+    name: string;
+    content: string;
+}>): string;
+/**
+ * 阶段级审查编排 — 审查指定阶段的全部产出。
+ *
+ * 对该阶段的所有注册产物逐一调用 orchestrateSingleArtifact(review)，
+ * 聚合结果为统一的 StageReviewResult。
+ */
+export declare function orchestrateStageReview(params: StageReviewParams): Promise<StageReviewResult>;
+//# sourceMappingURL=orchestrate_single_artifact.d.ts.map

package/dist/engine/pipeline/orchestrate_single_artifact.d.ts.map

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