@ai-dev-orchestrator/schemas 0.1.1

package/dist/workflow/workflow-file.d.ts

@@ -0,0 +1,331 @@
+import { z } from 'zod/v4';
+export declare const workflowSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    initialState: z.ZodString;
+    terminalStates: z.ZodArray<z.ZodString>;
+    states: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            judge: "judge";
+            action: "action";
+            review: "review";
+            gate: "gate";
+            wait: "wait";
+            terminal: "terminal";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodCatch<z.ZodString>;
+        entryActions: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+            type: z.ZodEnum<{
+                dispatch_worker: "dispatch_worker";
+                dispatch_parallel_workers: "dispatch_parallel_workers";
+                dispatch_dynamic_workers: "dispatch_dynamic_workers";
+                run_script: "run_script";
+                store_artifact: "store_artifact";
+                record_journal: "record_journal";
+                generate_agreement: "generate_agreement";
+                produce_manifest: "produce_manifest";
+                notify_human: "notify_human";
+            }>;
+            params: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            type: "dispatch_worker";
+            params: {
+                role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
+                parallel?: boolean | undefined;
+                branchId?: string | undefined;
+                stateId?: string | undefined;
+            };
+        } | {
+            type: "dispatch_parallel_workers";
+            params: {
+                roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
+                docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
+            };
+        } | {
+            type: "dispatch_dynamic_workers";
+            params: {
+                role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
+                sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                itemsPath: string;
+            };
+        } | {
+            type: "store_artifact";
+            params: {
+                type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                content: string;
+                name?: string | undefined;
+            };
+        } | {
+            type: "record_journal";
+            params: {
+                event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
+            };
+        } | {
+            type: "generate_agreement";
+            params: {
+                type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
+            };
+        } | {
+            type: "notify_human";
+            params: {
+                reason?: string | undefined;
+            };
+        } | {
+            type: "run_script";
+            params: {
+                script: string;
+                timeout?: number | undefined;
+                env?: Record<string, string> | undefined;
+                storeOutput?: {
+                    artifactType: string;
+                    producedBy: string;
+                } | undefined;
+            };
+        } | {
+            type: "produce_manifest";
+            params: Record<string, never>;
+        }, {
+            type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "produce_manifest" | "notify_human";
+            params: Record<string, unknown>;
+        }>>>>;
+        exitActions: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+            type: z.ZodEnum<{
+                dispatch_worker: "dispatch_worker";
+                dispatch_parallel_workers: "dispatch_parallel_workers";
+                dispatch_dynamic_workers: "dispatch_dynamic_workers";
+                run_script: "run_script";
+                store_artifact: "store_artifact";
+                record_journal: "record_journal";
+                generate_agreement: "generate_agreement";
+                produce_manifest: "produce_manifest";
+                notify_human: "notify_human";
+            }>;
+            params: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            type: "dispatch_worker";
+            params: {
+                role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
+                parallel?: boolean | undefined;
+                branchId?: string | undefined;
+                stateId?: string | undefined;
+            };
+        } | {
+            type: "dispatch_parallel_workers";
+            params: {
+                roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
+                docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
+            };
+        } | {
+            type: "dispatch_dynamic_workers";
+            params: {
+                role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
+                sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                itemsPath: string;
+            };
+        } | {
+            type: "store_artifact";
+            params: {
+                type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                content: string;
+                name?: string | undefined;
+            };
+        } | {
+            type: "record_journal";
+            params: {
+                event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
+            };
+        } | {
+            type: "generate_agreement";
+            params: {
+                type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
+            };
+        } | {
+            type: "notify_human";
+            params: {
+                reason?: string | undefined;
+            };
+        } | {
+            type: "run_script";
+            params: {
+                script: string;
+                timeout?: number | undefined;
+                env?: Record<string, string> | undefined;
+                storeOutput?: {
+                    artifactType: string;
+                    producedBy: string;
+                } | undefined;
+            };
+        } | {
+            type: "produce_manifest";
+            params: Record<string, never>;
+        }, {
+            type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "produce_manifest" | "notify_human";
+            params: Record<string, unknown>;
+        }>>>>;
+        transitions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            target: z.ZodString;
+            trigger: z.ZodEnum<{
+                timeout: "timeout";
+                failure: "failure";
+                completion: "completion";
+                review_approved: "review_approved";
+                review_rejected: "review_rejected";
+                iteration_exhausted: "iteration_exhausted";
+                judge_approved: "judge_approved";
+                judge_rejected: "judge_rejected";
+                escalation: "escalation";
+                human_input: "human_input";
+                human_approved: "human_approved";
+                human_rejected: "human_rejected";
+            }>;
+            guards: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+                type: z.ZodEnum<{
+                    artifact_exists: "artifact_exists";
+                    artifact_version_min: "artifact_version_min";
+                    agreement_exists: "agreement_exists";
+                    state_visited: "state_visited";
+                    iteration_below_limit: "iteration_below_limit";
+                    findings_indicate_plan_issue: "findings_indicate_plan_issue";
+                    known_failure_pattern: "known_failure_pattern";
+                    verification_failures_are_fixable: "verification_failures_are_fixable";
+                    verification_passed: "verification_passed";
+                    waiting_context_matches: "waiting_context_matches";
+                    plan_structure_valid: "plan_structure_valid";
+                    previous_run_pattern: "previous_run_pattern";
+                    specification_feasible: "specification_feasible";
+                    has_clarification_needs: "has_clarification_needs";
+                    synthesis_approved: "synthesis_approved";
+                    acceptance_passed: "acceptance_passed";
+                    triage_indicates_plan_issue: "triage_indicates_plan_issue";
+                    triage_needs_human: "triage_needs_human";
+                    confidence_threshold: "confidence_threshold";
+                    project_context_available: "project_context_available";
+                }>;
+                params: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>, z.ZodTransform<{
+                type: "artifact_exists";
+                params: {
+                    artifactType: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "artifact_version_min";
+                params: {
+                    artifactType: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
+                    minVersion: number;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "agreement_exists";
+                params: {
+                    agreementType: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "state_visited";
+                params: {
+                    stateId: string;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "iteration_below_limit";
+                params: {
+                    contract: string;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "waiting_context_matches";
+                params: {
+                    requestingState: string;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "findings_indicate_plan_issue";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "verification_failures_are_fixable";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "verification_passed";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "plan_structure_valid";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "specification_feasible";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "has_clarification_needs";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "synthesis_approved";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "acceptance_passed";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "known_failure_pattern";
+                params: {
+                    patternSubstring: string;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "previous_run_pattern";
+                params: {
+                    outcome: "escalated" | "completed" | "failed" | "aborted";
+                    waitForAll?: boolean | undefined;
+                    workflowVariant?: string | undefined;
+                    minOccurrences?: number | undefined;
+                };
+            } | {
+                type: "triage_indicates_plan_issue";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "triage_needs_human";
+                params: {
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "confidence_threshold";
+                params: {
+                    minConfidence: number;
+                    waitForAll?: boolean | undefined;
+                };
+            } | {
+                type: "project_context_available";
+                params: {
+                    waitForAll?: boolean | undefined;
+                    category?: "codebase" | "run_history" | "preferences" | undefined;
+                };
+            }, {
+                type: "artifact_exists" | "artifact_version_min" | "agreement_exists" | "state_visited" | "iteration_below_limit" | "findings_indicate_plan_issue" | "known_failure_pattern" | "verification_failures_are_fixable" | "verification_passed" | "waiting_context_matches" | "plan_structure_valid" | "previous_run_pattern" | "specification_feasible" | "has_clarification_needs" | "synthesis_approved" | "acceptance_passed" | "triage_indicates_plan_issue" | "triage_needs_human" | "confidence_threshold" | "project_context_available";
+                params: Record<string, unknown>;
+            }>>>>>;
+            governanceRequired: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            priority: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+    budget: z.ZodOptional<z.ZodObject<{
+        maxTokensPerRun: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkflowFile = z.infer<typeof workflowSchema>;

package/dist/workflow/workflow-file.js

@@ -0,0 +1,41 @@
+import { z } from 'zod/v4';
+import { ACTION_TYPES, GUARD_TYPES, STATE_TYPES, TRANSITION_TRIGGERS, workflowBudgetSchema, } from './workflow-engine';
+/**
+ * Loose Zod schema for camelCase workflow definition files (JSON/YAML after
+ * key normalization). Stricter domain shape is {@link workflowDefinitionSchema}.
+ */
+const workflowFileGuardSchema = z
+    .object({
+    type: z.enum(GUARD_TYPES),
+    params: z.record(z.string(), z.unknown()).catch({}),
+})
+    .transform((v) => v);
+const workflowFileActionSchema = z
+    .object({
+    type: z.enum(ACTION_TYPES),
+    params: z.record(z.string(), z.unknown()).catch({}),
+})
+    .transform((v) => v);
+const workflowFileTransitionSchema = z.object({
+    target: z.string(),
+    trigger: z.enum(TRANSITION_TRIGGERS),
+    guards: z.array(workflowFileGuardSchema).optional().default([]),
+    governanceRequired: z.boolean().optional().default(false),
+    priority: z.number().optional().default(0),
+});
+const workflowFileStateSchema = z.object({
+    type: z.enum(STATE_TYPES),
+    label: z.string().optional(),
+    description: z.string().catch(''),
+    entryActions: z.array(workflowFileActionSchema).optional(),
+    exitActions: z.array(workflowFileActionSchema).optional(),
+    transitions: z.array(workflowFileTransitionSchema).optional().default([]),
+});
+export const workflowSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().min(1),
+    initialState: z.string().min(1),
+    terminalStates: z.array(z.string()).min(1),
+    states: z.record(z.string(), workflowFileStateSchema),
+    budget: workflowBudgetSchema.optional(),
+});