ai-engineering-loop 2.9.0 → 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -136,19 +136,59 @@
136
136
  "additionalProperties": false
137
137
  },
138
138
  "flow": {
139
- "description": "Optional (C-21): the intended user flow as transitions. goal draft renders it as a From | Event | To table for the human to check before freeze; the receipt shows it next to the verification artifacts.",
139
+ "description": "Optional (C-21, C-27): the intended flow as transitions. goal draft renders it as a From | Event | To table; goal diagram renders it as a state machine, storyboard or actor lanes before freeze; the receipt shows it next to the verification artifacts.",
140
140
  "type": "array",
141
141
  "minItems": 1,
142
+ "maxItems": 40,
142
143
  "items": {
143
144
  "type": "object",
144
145
  "required": ["from", "event", "to"],
145
146
  "properties": {
146
147
  "from": { "type": "string", "minLength": 1 },
147
148
  "event": { "type": "string", "minLength": 1 },
148
- "to": { "type": "string", "minLength": 1 }
149
+ "to": { "type": "string", "minLength": 1 },
150
+ "actor": { "type": "string", "minLength": 1, "description": "Who performs the step (user, app, service, db, cron). Missing means user." },
151
+ "guard": { "type": "string", "minLength": 1 },
152
+ "effects": {
153
+ "type": "array",
154
+ "maxItems": 12,
155
+ "items": {
156
+ "type": "object",
157
+ "required": ["text"],
158
+ "properties": {
159
+ "text": { "type": "string", "minLength": 1 },
160
+ "ac": { "type": "string", "minLength": 1, "description": "Acceptance criterion that covers this effect. Missing means a side effect no AC covers." }
161
+ }
162
+ }
163
+ },
164
+ "hotspot": { "description": "An open question about this transition, or true.", "oneOf": [{ "type": "string", "minLength": 1 }, { "const": true }] }
149
165
  }
150
166
  }
151
167
  },
168
+ "flowSubject": {
169
+ "description": "Optional (C-27): the entity whose status the flow describes; makes the state view the recommended one.",
170
+ "type": "string",
171
+ "minLength": 1
172
+ },
173
+ "forbiddenTransitions": {
174
+ "description": "Optional (C-27): state/event pairs the human decided are invalid; the transition table shows them as invalid instead of undecided.",
175
+ "type": "array",
176
+ "items": {
177
+ "type": "object",
178
+ "required": ["from", "event"],
179
+ "properties": {
180
+ "from": { "type": "string", "minLength": 1 },
181
+ "event": { "type": "string", "minLength": 1 }
182
+ },
183
+ "additionalProperties": false
184
+ }
185
+ },
186
+ "plainSummary": {
187
+ "description": "Optional (C-28): one sentence for non-technical readers, used by `recap --for client`.",
188
+ "type": "string",
189
+ "minLength": 1,
190
+ "maxLength": 240
191
+ },
152
192
  "featureId": {
153
193
  "description": "Optional (C-15): id of the feature in .ai-engineering-loop/features.json this Goal delivers. Goal freeze marks it active; delivery marks it passing with this Run as evidence.",
154
194
  "type": "string",