@lmctl-ai/lmctl 0.1.0

package/workflows/example-v2.compound.json

@@ -0,0 +1,200 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "example-v2",
+  "version": 1,
+  "description": "Demonstrates a simple multi-step workflow with agent work and review for smoke testing and template examples.",
+  "estimated_duration_ms": 30000,
+  "errors": {
+    "on_unhandled_failure": {
+      "attention_kind": "workflow_failed",
+      "severity": "error",
+      "capture_evidence": true
+    }
+  },
+  "steps": [
+    {
+      "id": "s-research-c47b",
+      "name": "research",
+      "type": "lmctl/consolidate",
+      "typeVersion": 1,
+      "parameters": {
+        "research_artifact_prefix": "research"
+      },
+      "members": {
+        "researchers": [
+          {
+            "team": "default",
+            "alias": "Researcher",
+            "prompt_template": "Research the existing test patterns in the project at {{project.local_path}} and summarise your findings.",
+            "topic": "existing tests and test patterns"
+          },
+          {
+            "team": "default",
+            "alias": "Researcher2",
+            "prompt_template": "Summarise the bug described in: {{job_payload.description}}",
+            "topic": "bug description from job payload"
+          }
+        ],
+        "consolidator": {
+          "team": "default",
+          "alias": "Consolidator",
+          "prompt_template": "Given the research inputs below, produce a consolidated analysis plan. End with STANCE: ok"
+        }
+      }
+    },
+    {
+      "id": "s-code-review-dd5c",
+      "name": "code_review",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "parameters": {
+        "pre_checks": [
+          {
+            "kind": "shell",
+            "command": "git -C {{project.local_path}} diff --quiet HEAD || true",
+            "description": "check repo accessible"
+          }
+        ],
+        "writes_to_project_path": true,
+        "max_loops": 3
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "Fix the bug described in {{job_payload.description}} in {{project.local_path}}. When done, respond with STANCE: done"
+        },
+        "reviewers": [
+          {
+            "team": "default",
+            "alias": "Reviewer",
+            "prompt_template": "Review the coder's work. If satisfactory respond STANCE: approve, otherwise respond STANCE: request_changes followed by feedback."
+          }
+        ]
+      }
+    },
+    {
+      "id": "s-interactive-handoff-7a4f",
+      "name": "interactive_handoff",
+      "type": "lmctl/interactive",
+      "typeVersion": 1,
+      "parameters": {
+        "termination": {
+          "operator_signal": true,
+          "agent_signal": "HANDOFF_COMPLETE",
+          "max_turns": 5
+        },
+        "artifact_name": "handoff_summary"
+      },
+      "members": {
+        "agent": {
+          "team": "default",
+          "alias": "Coder",
+          "initial_prompt_template": "The fix has been reviewed and approved. Please summarise the changes made to {{project.local_path}} for the operator. When you are done, include the text HANDOFF_COMPLETE in your response."
+        }
+      }
+    },
+    {
+      "id": "s-terminal-aborted-df78",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    },
+    {
+      "id": "s-terminal-done-bb66",
+      "name": "terminal:done",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "done",
+        "kind": "success"
+      }
+    }
+  ],
+  "connections": {
+    "s-research-c47b": {
+      "ok": [
+        [
+          {
+            "step_id": "s-code-review-dd5c",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "error": [
+        [
+          {
+            "step_id": "s-terminal-aborted-df78",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-code-review-dd5c": {
+      "approve": [
+        [
+          {
+            "step_id": "s-interactive-handoff-7a4f",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "request_changes": [
+        [
+          {
+            "step_id": "s-code-review-dd5c",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "fail_pre_check": [
+        [
+          {
+            "step_id": "s-terminal-aborted-df78",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "max_loops_exceeded": [
+        [
+          {
+            "step_id": "s-terminal-aborted-df78",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-interactive-handoff-7a4f": {
+      "done": [
+        [
+          {
+            "step_id": "s-terminal-done-bb66",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "timeout": [
+        [
+          {
+            "step_id": "s-terminal-aborted-df78",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-research-c47b"
+}

package/workflows/image-qa.compound.json

@@ -0,0 +1,128 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "image-qa",
+  "version": 1,
+  "description": "Reviews image or visual output against expected criteria and produces a QA verdict with evidence.",
+  "estimated_duration_ms": 90000,
+  "errors": {
+    "on_unhandled_failure": {
+      "attention_kind": "workflow_failed",
+      "severity": "error",
+      "capture_evidence": true
+    }
+  },
+  "inputs": [
+    {
+      "name": "image_path",
+      "type": "string",
+      "required": true,
+      "description": "Absolute path to the uploaded image or document."
+    },
+    {
+      "name": "prompt",
+      "type": "string",
+      "required": true,
+      "description": "Question or instruction for the image."
+    }
+  ],
+  "outputs": [
+    {
+      "name": "answer",
+      "type": "string",
+      "source_step_id": "image_qa:coder[0]",
+      "source_field": "image_qa:coder[0]_transcript",
+      "description": "Coder's markdown answer about the uploaded image."
+    }
+  ],
+  "steps": [
+    {
+      "id": "s-image-qa-4f9a",
+      "name": "image_qa",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "estimated_duration_ms": 90000,
+      "parameters": {
+        "max_loops": 1
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "You are an agent answering a layman's question about an image or document they uploaded.\n\nImage path: ={{ context.inputs.image_path }}\nUser's question: ={{ context.inputs.prompt }}\n\nPlease read the file at the path above. Then answer the user's question with specific visual details. If it is a document, bill, or letter, transcribe the visible text you can read. Return your answer as markdown.\n\nEnd with exactly:\nSTANCE: ok\n\nIf you cannot read the file, explain the limitation and end with exactly:\nSTANCE: blocked"
+        },
+        "reviewers": []
+      }
+    },
+    {
+      "id": "s-terminal-done-a9c1",
+      "name": "terminal:done",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "done",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-aborted-b6e2",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    }
+  ],
+  "connections": {
+    "s-image-qa-4f9a": {
+      "approve": [
+        [
+          {
+            "step_id": "s-terminal-done-a9c1",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "ok": [
+        [
+          {
+            "step_id": "s-terminal-done-a9c1",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "blocked": [
+        [
+          {
+            "step_id": "s-terminal-aborted-b6e2",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "aborted": [
+        [
+          {
+            "step_id": "s-terminal-aborted-b6e2",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "rejected": [
+        [
+          {
+            "step_id": "s-terminal-aborted-b6e2",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-image-qa-4f9a"
+}

package/workflows/index.jsonl

@@ -0,0 +1,15 @@
+{"name":"bugfix-extended-v2","file":"bugfix-extended-v2.compound.json","description":"Investigates a bug report, develops a fix through coder and reviewer turns, verifies the result, and reports the final status."}
+{"name":"bugfix-v2","file":"bugfix-v2.compound.json","description":"Takes a bug description, asks an agent to diagnose and fix it in the project, then verifies and reports the outcome."}
+{"name":"claim-check-spike-v2","file":"claim-check-spike-v2.compound.json","description":"Explores whether project issue claiming and follow-up work queues behave correctly for a small spike workflow."}
+{"name":"document-creation","file":"document-creation.compound.json","description":"Creates or revises a project document through agent drafting and review, then writes the accepted document to the project."}
+{"name":"durable-memory-consolidation-v2","file":"durable-memory-consolidation-v2.compound.json","description":"Consolidates durable project memory from recent work so future sessions can recover important context quickly."}
+{"name":"example-v2","file":"example-v2.compound.json","description":"Demonstrates a simple multi-step workflow with agent work and review for smoke testing and template examples."}
+{"name":"image-qa","file":"image-qa.compound.json","description":"Reviews image or visual output against expected criteria and produces a QA verdict with evidence."}
+{"name":"info-qa","file":"info-qa.compound.json","description":"Runs an information-oriented QA workflow that checks project facts, evidence, and expected outcomes without modifying the project."}
+{"name":"newspaper","file":"newspaper.compound.json","description":"Builds a newspaper-style summary from project or external inputs, organizing findings into a readable generated artifact."}
+{"name":"pr-fix","file":"pr-fix.compound.json","description":"Claims one project issue, reads the failing test chapter, fixes the project with coder/reviewer loop, commits, and closes the issue."}
+{"name":"pr-followup-v2","file":"pr-followup-v2.compound.json","description":"Follows up on pull-request feedback, applies needed changes, verifies them, and reports whether the PR is ready."}
+{"name":"provider-probe","file":"provider-probe.compound.json","description":"Checks whether configured AI providers and team members can respond successfully in the current environment."}
+{"name":"qa-suite","file":"qa-suite.compound.json","description":"Runs project QA chapters, interprets failures, creates project issues for failing chapters, and reports the open issue count."}
+{"name":"spec-driven-task","file":"spec-driven-task.compound.json","description":"Turns a written task specification into project changes through agent implementation, review, and verification."}
+{"name":"triage-v2","file":"triage-v2.compound.json","description":"Triages incoming issues, filters duplicates or unclear reports, assesses fixability, and produces candidate work items."}

package/workflows/info-qa.compound.json

@@ -0,0 +1,120 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "info-qa",
+  "version": 1,
+  "description": "Runs an information-oriented QA workflow that checks project facts, evidence, and expected outcomes without modifying the project.",
+  "estimated_duration_ms": 90000,
+  "errors": {
+    "on_unhandled_failure": {
+      "attention_kind": "workflow_failed",
+      "severity": "error",
+      "capture_evidence": true
+    }
+  },
+  "inputs": [
+    {
+      "name": "question",
+      "type": "string",
+      "required": true,
+      "description": "Question to answer."
+    },
+    {
+      "name": "output_path",
+      "type": "string",
+      "required": false,
+      "description": "Optional markdown path for the consolidated answer."
+    }
+  ],
+  "outputs": [
+    {
+      "name": "answer",
+      "type": "string",
+      "source_step_id": "s-info-qa-7b4c",
+      "source_field": "consolidated_output",
+      "description": "Consolidated answer."
+    }
+  ],
+  "steps": [
+    {
+      "id": "s-info-qa-7b4c",
+      "name": "info_qa",
+      "type": "lmctl/consolidate",
+      "typeVersion": 1,
+      "estimated_duration_ms": 90000,
+      "parameters": {
+        "research_artifact_prefix": "info_qa"
+      },
+      "members": {
+        "researchers": [
+          {
+            "team": "default",
+            "alias": "ClaudeResearcher",
+            "topic": "Claude research perspective",
+            "prompt_template": "Research the question carefully and identify key facts, caveats, and source-quality concerns.\n\nQuestion: {{job_payload.question}}"
+          },
+          {
+            "team": "default",
+            "alias": "CodexResearcher",
+            "topic": "Codex research perspective",
+            "prompt_template": "Analyze the question from a second perspective. Focus on concrete evidence, contradictions, and what an operator should verify.\n\nQuestion: {{job_payload.question}}"
+          },
+          {
+            "team": "default",
+            "alias": "GeminiResearcher",
+            "topic": "Gemini research perspective",
+            "prompt_template": "Produce an independent answer draft with assumptions, uncertainty, and practical next steps.\n\nQuestion: {{job_payload.question}}"
+          }
+        ],
+        "consolidator": {
+          "team": "default",
+          "alias": "Consolidator",
+          "prompt_template": "Merge the research notes into one concise answer for a non-specialist. Keep claims grounded, identify uncertainty, and include next steps when useful.\n\nIf job_payload.output_path is set, write the final markdown answer there.\n\nEnd with exactly:\nSTANCE: ok"
+        }
+      }
+    },
+    {
+      "id": "s-terminal-done-f1a8",
+      "name": "terminal:done",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "done",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-aborted-3d2e",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    }
+  ],
+  "connections": {
+    "s-info-qa-7b4c": {
+      "ok": [
+        [
+          {
+            "step_id": "s-terminal-done-f1a8",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "error": [
+        [
+          {
+            "step_id": "s-terminal-aborted-3d2e",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-info-qa-7b4c"
+}

package/workflows/newspaper.compound.json

@@ -0,0 +1,129 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "newspaper",
+  "version": 1,
+  "description": "Builds a newspaper-style summary from project or external inputs, organizing findings into a readable generated artifact.",
+  "estimated_duration_ms": 120000,
+  "errors": {
+    "on_unhandled_failure": {
+      "attention_kind": "workflow_failed",
+      "severity": "error",
+      "capture_evidence": true
+    }
+  },
+  "triggers": [
+    {
+      "id": "daily-digest",
+      "type": "lmctl/trigger-schedule",
+      "parameters": {
+        "cron": "0 6 * * *",
+        "timezone": "UTC"
+      }
+    }
+  ],
+  "inputs": [
+    {
+      "name": "topics",
+      "type": "array",
+      "required": true,
+      "description": "Topics to include in the digest."
+    },
+    {
+      "name": "output_dir",
+      "type": "string",
+      "required": false,
+      "description": "Optional output directory for digest markdown."
+    }
+  ],
+  "outputs": [
+    {
+      "name": "digest_md",
+      "type": "string",
+      "source_step_id": "s-gather-digest-4f0a",
+      "source_field": "consolidated_output",
+      "description": "Daily digest markdown."
+    }
+  ],
+  "steps": [
+    {
+      "id": "s-gather-digest-4f0a",
+      "name": "gather",
+      "type": "lmctl/consolidate",
+      "typeVersion": 1,
+      "parameters": {
+        "research_artifact_prefix": "newspaper"
+      },
+      "members": {
+        "researchers": [
+          {
+            "team": "default",
+            "alias": "Researcher1",
+            "topic": "Topic set A",
+            "prompt_template": "Research the first slice of the requested daily digest topics.\n\nTopics: {{job_payload.topics}}\nOutput directory: {{job_payload.output_dir}}"
+          },
+          {
+            "team": "default",
+            "alias": "Researcher2",
+            "topic": "Topic set B",
+            "prompt_template": "Research a second independent slice of the requested daily digest topics. Note contradictions and uncertainty.\n\nTopics: {{job_payload.topics}}\nOutput directory: {{job_payload.output_dir}}"
+          },
+          {
+            "team": "default",
+            "alias": "Researcher3",
+            "topic": "Topic set C",
+            "prompt_template": "Research a third independent slice of the requested daily digest topics. Prefer concise facts and source-quality notes.\n\nTopics: {{job_payload.topics}}\nOutput directory: {{job_payload.output_dir}}"
+          }
+        ],
+        "consolidator": {
+          "team": "default",
+          "alias": "Consolidator",
+          "prompt_template": "Merge the research into a readable daily newspaper-style markdown digest. Group by topic, keep it concise, and include caveats.\n\nIf job_payload.output_dir is set, write the digest markdown there.\n\nEnd with exactly:\nSTANCE: ok"
+        }
+      }
+    },
+    {
+      "id": "s-terminal-done-a615",
+      "name": "terminal:done",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "done",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-aborted-cc74",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    }
+  ],
+  "connections": {
+    "s-gather-digest-4f0a": {
+      "ok": [
+        [
+          {
+            "step_id": "s-terminal-done-a615",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "error": [
+        [
+          {
+            "step_id": "s-terminal-aborted-cc74",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-gather-digest-4f0a"
+}