mlua-swarm-cli 0.12.0

Command line interface for mlua-swarm (mse binary with serve / mcp subcommands).
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
{
  "agents": [
    {
      "$agent_md": "prepare.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "setup.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "gather.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "implement.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "polish.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "review.md",
      "spec": {
        "operator_ref": "main-ai"
      },
      "verdict": {
        "channel": "part",
        "values": [
          "PASS",
          "BLOCKED"
        ]
      }
    },
    {
      "$agent_md": "record.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "merge.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    },
    {
      "$agent_md": "fixer.md",
      "spec": {
        "operator_ref": "main-ai"
      }
    }
  ],
  "flow": {
    "children": [
      {
        "in": {
          "at": "$.d.prep",
          "op": "path"
        },
        "kind": "step",
        "out": {
          "at": "$.prepared",
          "op": "path"
        },
        "ref": "prepare"
      },
      {
        "cond": {
          "lhs": {
            "at": "$.prepared.parts[\"verdict\"]",
            "op": "path"
          },
          "op": "eq",
          "rhs": {
            "op": "lit",
            "value": "BLOCKED"
          }
        },
        "else": {
          "children": [
            {
              "in": {
                "at": "$.d.setup_dir",
                "op": "path"
              },
              "kind": "step",
              "out": {
                "at": "$.workspace",
                "op": "path"
              },
              "ref": "setup"
            },
            {
              "cond": {
                "lhs": {
                  "at": "$.workspace.parts[\"verdict\"]",
                  "op": "path"
                },
                "op": "eq",
                "rhs": {
                  "op": "lit",
                  "value": "BLOCKED"
                }
              },
              "else": {
                "children": [
                  {
                    "in": {
                      "at": "$.d.gather_ctx",
                      "op": "path"
                    },
                    "kind": "step",
                    "out": {
                      "at": "$.context",
                      "op": "path"
                    },
                    "ref": "gather"
                  },
                  {
                    "cond": {
                      "lhs": {
                        "at": "$.context.parts[\"verdict\"]",
                        "op": "path"
                      },
                      "op": "eq",
                      "rhs": {
                        "op": "lit",
                        "value": "BLOCKED"
                      }
                    },
                    "else": {
                      "children": [
                        {
                          "in": {
                            "at": "$.d.impl",
                            "op": "path"
                          },
                          "kind": "step",
                          "out": {
                            "at": "$.implemented",
                            "op": "path"
                          },
                          "ref": "implement"
                        },
                        {
                          "cond": {
                            "lhs": {
                              "at": "$.implemented.parts[\"verdict\"]",
                              "op": "path"
                            },
                            "op": "eq",
                            "rhs": {
                              "op": "lit",
                              "value": "BLOCKED"
                            }
                          },
                          "else": {
                            "children": [
                              {
                                "in": {
                                  "at": "$.d.polish_rules",
                                  "op": "path"
                                },
                                "kind": "step",
                                "out": {
                                  "at": "$.polished",
                                  "op": "path"
                                },
                                "ref": "polish"
                              },
                              {
                                "cond": {
                                  "lhs": {
                                    "at": "$.polished.parts[\"verdict\"]",
                                    "op": "path"
                                  },
                                  "op": "eq",
                                  "rhs": {
                                    "op": "lit",
                                    "value": "BLOCKED"
                                  }
                                },
                                "else": {
                                  "children": [
                                    {
                                      "in": {
                                        "at": "$.d.review",
                                        "op": "path"
                                      },
                                      "kind": "step",
                                      "out": {
                                        "at": "$.review_verdict",
                                        "op": "path"
                                      },
                                      "ref": "review"
                                    },
                                    {
                                      "body": {
                                        "children": [
                                          {
                                            "in": {
                                              "at": "$.review_verdict",
                                              "op": "path"
                                            },
                                            "kind": "step",
                                            "out": {
                                              "at": "$.fix",
                                              "op": "path"
                                            },
                                            "ref": "fixer"
                                          },
                                          {
                                            "in": {
                                              "at": "$.d.review",
                                              "op": "path"
                                            },
                                            "kind": "step",
                                            "out": {
                                              "at": "$.review_verdict",
                                              "op": "path"
                                            },
                                            "ref": "review"
                                          }
                                        ],
                                        "kind": "seq"
                                      },
                                      "cond": {
                                        "args": [
                                          {
                                            "lhs": {
                                              "at": "$.rv_n",
                                              "op": "path"
                                            },
                                            "op": "lt",
                                            "rhs": {
                                              "op": "lit",
                                              "value": 2
                                            }
                                          },
                                          {
                                            "lhs": {
                                              "at": "$.review_verdict.parts[\"verdict\"]",
                                              "op": "path"
                                            },
                                            "op": "eq",
                                            "rhs": {
                                              "op": "lit",
                                              "value": "BLOCKED"
                                            }
                                          }
                                        ],
                                        "op": "and"
                                      },
                                      "counter": {
                                        "at": "$.rv_n",
                                        "op": "path"
                                      },
                                      "kind": "loop",
                                      "max": 3
                                    },
                                    {
                                      "cond": {
                                        "lhs": {
                                          "at": "$.review_verdict.parts[\"verdict\"]",
                                          "op": "path"
                                        },
                                        "op": "eq",
                                        "rhs": {
                                          "op": "lit",
                                          "value": "BLOCKED"
                                        }
                                      },
                                      "else": {
                                        "children": [
                                          {
                                            "in": {
                                              "at": "$.d.record",
                                              "op": "path"
                                            },
                                            "kind": "step",
                                            "out": {
                                              "at": "$.recorded",
                                              "op": "path"
                                            },
                                            "ref": "record"
                                          },
                                          {
                                            "cond": {
                                              "lhs": {
                                                "at": "$.recorded.parts[\"verdict\"]",
                                                "op": "path"
                                              },
                                              "op": "eq",
                                              "rhs": {
                                                "op": "lit",
                                                "value": "BLOCKED"
                                              }
                                            },
                                            "else": {
                                              "children": [
                                                {
                                                  "in": {
                                                    "at": "$.d.merge_target",
                                                    "op": "path"
                                                  },
                                                  "kind": "step",
                                                  "out": {
                                                    "at": "$.merged",
                                                    "op": "path"
                                                  },
                                                  "ref": "merge"
                                                },
                                                {
                                                  "cond": {
                                                    "lhs": {
                                                      "at": "$.merged.parts[\"verdict\"]",
                                                      "op": "path"
                                                    },
                                                    "op": "eq",
                                                    "rhs": {
                                                      "op": "lit",
                                                      "value": "BLOCKED"
                                                    }
                                                  },
                                                  "else": {
                                                    "at": {
                                                      "at": "$.pipeline_complete",
                                                      "op": "path"
                                                    },
                                                    "kind": "assign",
                                                    "value": {
                                                      "op": "lit",
                                                      "value": true
                                                    }
                                                  },
                                                  "kind": "branch",
                                                  "then": {
                                                    "at": {
                                                      "at": "$.halted_at",
                                                      "op": "path"
                                                    },
                                                    "kind": "assign",
                                                    "value": {
                                                      "op": "lit",
                                                      "value": "merge"
                                                    }
                                                  }
                                                }
                                              ],
                                              "kind": "seq"
                                            },
                                            "kind": "branch",
                                            "then": {
                                              "at": {
                                                "at": "$.halted_at",
                                                "op": "path"
                                              },
                                              "kind": "assign",
                                              "value": {
                                                "op": "lit",
                                                "value": "record"
                                              }
                                            }
                                          }
                                        ],
                                        "kind": "seq"
                                      },
                                      "kind": "branch",
                                      "then": {
                                        "at": {
                                          "at": "$.halted_at",
                                          "op": "path"
                                        },
                                        "kind": "assign",
                                        "value": {
                                          "op": "lit",
                                          "value": "review"
                                        }
                                      }
                                    }
                                  ],
                                  "kind": "seq"
                                },
                                "kind": "branch",
                                "then": {
                                  "at": {
                                    "at": "$.halted_at",
                                    "op": "path"
                                  },
                                  "kind": "assign",
                                  "value": {
                                    "op": "lit",
                                    "value": "polish"
                                  }
                                }
                              }
                            ],
                            "kind": "seq"
                          },
                          "kind": "branch",
                          "then": {
                            "at": {
                              "at": "$.halted_at",
                              "op": "path"
                            },
                            "kind": "assign",
                            "value": {
                              "op": "lit",
                              "value": "implement"
                            }
                          }
                        }
                      ],
                      "kind": "seq"
                    },
                    "kind": "branch",
                    "then": {
                      "at": {
                        "at": "$.halted_at",
                        "op": "path"
                      },
                      "kind": "assign",
                      "value": {
                        "op": "lit",
                        "value": "gather"
                      }
                    }
                  }
                ],
                "kind": "seq"
              },
              "kind": "branch",
              "then": {
                "at": {
                  "at": "$.halted_at",
                  "op": "path"
                },
                "kind": "assign",
                "value": {
                  "op": "lit",
                  "value": "setup"
                }
              }
            }
          ],
          "kind": "seq"
        },
        "kind": "branch",
        "then": {
          "at": {
            "at": "$.halted_at",
            "op": "path"
          },
          "kind": "assign",
          "value": {
            "op": "lit",
            "value": "prepare"
          }
        }
      }
    ],
    "kind": "seq"
  },
  "id": "sample-pipeline",
  "metadata": {
    "default_run_ttl_secs": 5400,
    "description": "Nine verdict-gated stages in sequence with a bounded fix-and-regate retry loop around the review stage. Callers seed per-stage directives under init_ctx.d and the retry counter rv_n=0. The review agent declares a verdict contract (channel=part, values=[PASS, BLOCKED]) so compile-time cond lint and submit-time gating protect the loop shape."
  },
  "operators": [
    {
      "display_name": "Main operator",
      "kind": "main_ai",
      "name": "main-ai",
      "spec": {}
    }
  ],
  "strategy": {
    "strict_kind": true,
    "strict_refs": true
  }
}