ralph-workflow 0.7.18

PROMPT-driven multi-agent orchestrator for git repos
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

<?xml version="1.0" encoding="UTF-8"?>
<!--
  Commit Message XSD Schema
  
  Allows <code> elements within text content for escaping special characters
  like <, >, and & (e.g., comparisons, generics, logical operators).
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  
  <!-- Text with optional inline code elements -->
  <xs:complexType name="TextWithCodeType" mixed="true">
    <xs:choice minOccurs="0" maxOccurs="unbounded">
      <xs:element name="code" type="xs:string"/>
    </xs:choice>
  </xs:complexType>
  
  <!-- File list type: holds individual file paths the agent wants to commit -->
  <xs:complexType name="FileListType">
    <xs:sequence>
      <xs:element name="ralph-file" type="TextWithCodeType" minOccurs="1" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <!-- Allowed reason values for excluded files -->
  <xs:simpleType name="ExcludedFileReasonType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="internal-ignore"/>
      <xs:enumeration value="not-task-related"/>
      <xs:enumeration value="sensitive"/>
      <xs:enumeration value="deferred"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- Single excluded file entry: repo-relative path + required reason -->
  <xs:complexType name="ExcludedFileEntryType">
    <xs:simpleContent>
      <xs:extension base="xs:string">
        <xs:attribute name="reason" type="ExcludedFileReasonType" use="required"/>
      </xs:extension>
    </xs:simpleContent>
  </xs:complexType>

  <!-- Excluded file list: at least one entry required when element is present -->
  <xs:complexType name="ExcludedFileListType">
    <xs:sequence>
      <xs:element name="ralph-excluded-file" type="ExcludedFileEntryType"
                  minOccurs="1" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:element name="ralph-commit">
    <xs:complexType>
      <xs:choice>
        <!-- Normal commit message -->
        <xs:sequence>
           <xs:element name="ralph-subject" type="TextWithCodeType"/>
           <!--
             Allow file/excluded metadata and body tags in either sibling order.
             The Rust validator accepts these tags regardless of order; the published XSD
             should be similarly permissive to reduce unnecessary XSD-retry churn.
           -->
           <xs:choice minOccurs="0">
             <!-- Body block before file metadata -->
             <xs:sequence>
               <!-- Body is mutually exclusive: either simple <ralph-body> OR detailed tags. -->
               <xs:choice minOccurs="0">
                 <xs:element name="ralph-body" type="TextWithCodeType"/>
                 <xs:sequence>
                   <!-- Detailed body tags: order-insensitive (duplicates rejected by Rust validator). -->
                   <xs:choice minOccurs="0" maxOccurs="3">
                     <xs:element name="ralph-body-summary" type="TextWithCodeType"/>
                     <xs:element name="ralph-body-details" type="TextWithCodeType"/>
                     <xs:element name="ralph-body-footer" type="TextWithCodeType"/>
                   </xs:choice>
                 </xs:sequence>
               </xs:choice>
               <!-- Optional file list / excluded metadata in either order -->
               <xs:choice minOccurs="0" maxOccurs="2">
                 <xs:element name="ralph-files" type="FileListType"/>
                 <xs:element name="ralph-excluded-files" type="ExcludedFileListType"/>
               </xs:choice>
             </xs:sequence>
             <!-- File metadata before body block -->
             <xs:sequence>
               <xs:choice minOccurs="0" maxOccurs="2">
                 <xs:element name="ralph-files" type="FileListType"/>
                 <xs:element name="ralph-excluded-files" type="ExcludedFileListType"/>
               </xs:choice>
               <xs:choice minOccurs="0">
                 <xs:element name="ralph-body" type="TextWithCodeType"/>
                 <xs:sequence>
                   <xs:choice minOccurs="0" maxOccurs="3">
                     <xs:element name="ralph-body-summary" type="TextWithCodeType"/>
                     <xs:element name="ralph-body-details" type="TextWithCodeType"/>
                     <xs:element name="ralph-body-footer" type="TextWithCodeType"/>
                   </xs:choice>
                 </xs:sequence>
               </xs:choice>
             </xs:sequence>
           </xs:choice>
        </xs:sequence>
        <!-- Skip commit (no changes found) -->
        <xs:element name="ralph-skip" type="TextWithCodeType"/>
      </xs:choice>
    </xs:complexType>
  </xs:element>
</xs:schema>