@lmctl-ai/lmctl 0.1.0

package/workflows/claim-check-spike-v2.compound.json

@@ -0,0 +1,136 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "claim-check-spike-v2",
+  "version": 1,
+  "description": "Explores whether project issue claiming and follow-up work queues behave correctly for a small spike workflow.",
+  "estimated_duration_ms": 60000,
+  "default_task_timeout_ms": 1800000,
+  "steps": [
+    {
+      "id": "s-claim-check-6e5a",
+      "name": "claim_check",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "parameters": {
+        "max_loops": 5
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "You are evaluating whether a GitHub issue is open and unclaimed. The job payload is JSON with an issue_url field.\n\nJob payload:\n{{job_payload}}\n\nSteps:\n1. Run `gh issue view <issue_url> --json state,assignees,labels,comments --jq '{state, assignees: [.assignees[].login], labels: [.labels[].name], comments: [.comments[] | {author: .author.login, body: .body[0:200]}]}'` and read the result.\n2. Decide one of these outcomes:\n   - `open`: state is open and no human assignee is actively working it (auto-triage assignees are OK; comments do not say \"working on this\")\n   - `claimed`: state is open and a human says they're working on it OR an active assignee has commented within the last 7 days\n   - `dup_pr_active`: comments mention an open PR addressing this issue\n   - `closed`: state is closed\n   - `failed`: gh call errored or output is malformed\n3. Reply with prose explaining your reading, then close with `STANCE: <outcome>`.\n\nOnly output one final STANCE line."
+        }
+      }
+    },
+    {
+      "id": "s-terminal-aborted-34b4",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    },
+    {
+      "id": "s-terminal-open-3378",
+      "name": "terminal:open",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "open",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-claimed-f484",
+      "name": "terminal:claimed",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "claimed",
+        "kind": "neutral"
+      }
+    },
+    {
+      "id": "s-terminal-dup-pr-active-77cd",
+      "name": "terminal:dup_pr_active",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "dup_pr_active",
+        "kind": "neutral"
+      }
+    },
+    {
+      "id": "s-terminal-closed-f026",
+      "name": "terminal:closed",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "closed",
+        "kind": "neutral"
+      }
+    }
+  ],
+  "connections": {
+    "s-claim-check-6e5a": {
+      "approve": [
+        [
+          {
+            "step_id": "s-terminal-aborted-34b4",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "open": [
+        [
+          {
+            "step_id": "s-terminal-open-3378",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "claimed": [
+        [
+          {
+            "step_id": "s-terminal-claimed-f484",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "dup_pr_active": [
+        [
+          {
+            "step_id": "s-terminal-dup-pr-active-77cd",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "closed": [
+        [
+          {
+            "step_id": "s-terminal-closed-f026",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "failed": [
+        [
+          {
+            "step_id": "s-terminal-aborted-34b4",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-claim-check-6e5a"
+}

package/workflows/document-creation.compound.json

@@ -0,0 +1,200 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "document-creation",
+  "version": 1,
+  "description": "Creates or revises a project document through agent drafting and review, then writes the accepted document to the project.",
+  "estimated_duration_ms": 120000,
+  "errors": {
+    "on_unhandled_failure": {
+      "attention_kind": "workflow_failed",
+      "severity": "error",
+      "capture_evidence": true
+    }
+  },
+  "inputs": [
+    {
+      "name": "task_description",
+      "type": "string",
+      "required": true,
+      "description": "Document request."
+    },
+    {
+      "name": "slug",
+      "type": "string",
+      "required": true,
+      "description": "Filesystem-safe document slug."
+    },
+    {
+      "name": "output_dir",
+      "type": "string",
+      "required": false,
+      "description": "Optional output directory for markdown draft artifacts."
+    }
+  ],
+  "outputs": [
+    {
+      "name": "document_md",
+      "type": "string",
+      "source_step_id": "s-review-document-0d4a",
+      "source_field": "output",
+      "description": "Reviewed markdown document."
+    },
+    {
+      "name": "document_docx",
+      "type": "string",
+      "source_step_id": "s-render-docx-a02a",
+      "source_field": "output_path",
+      "description": "Rendered DOCX output path."
+    }
+  ],
+  "steps": [
+    {
+      "id": "s-chat-draft-9c12",
+      "name": "chat",
+      "type": "lmctl/interactive",
+      "typeVersion": 1,
+      "parameters": {
+        "termination": {
+          "operator_signal": true,
+          "agent_signal": "DOCUMENT_CHAT_DONE",
+          "max_turns": 8
+        },
+        "artifact_name": "chat_output_md"
+      },
+      "members": {
+        "agent": {
+          "team": "default",
+          "alias": "Coder",
+          "initial_prompt_template": "Work with the operator to draft a markdown document.\n\nTask: {{job_payload.task_description}}\nSlug: {{job_payload.slug}}\nOutput directory: {{job_payload.output_dir}}\n\nWhen the draft is ready for review, include DOCUMENT_CHAT_DONE in your response."
+        }
+      }
+    },
+    {
+      "id": "s-review-document-0d4a",
+      "name": "review",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "parameters": {
+        "max_loops": 2
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "Refine the markdown draft from the chat stage into a polished document.\n\nTask: {{job_payload.task_description}}\nSlug: {{job_payload.slug}}\nOutput directory: {{job_payload.output_dir}}\n\nReturn the final markdown body and end with STANCE: done."
+        },
+        "reviewers": [
+          {
+            "team": "default",
+            "alias": "Reviewer",
+            "prompt_template": "Review the markdown document for clarity, completeness, and audience fit. Respond STANCE: approve if ready; otherwise STANCE: request_changes followed by concise revision notes."
+          }
+        ]
+      }
+    },
+    {
+      "id": "s-render-docx-a02a",
+      "name": "render",
+      "type": "lmctl/render-docx",
+      "typeVersion": 1,
+      "parameters": {
+        "markdown_source": "={{ context.outcomes.review.output }}",
+        "output_path": "={{ (context.inputs.output_dir || 'drafts') + '/' + context.inputs.slug + '.docx' }}",
+        "title": "={{ context.inputs.task_description }}"
+      }
+    },
+    {
+      "id": "s-terminal-done-f7c0",
+      "name": "terminal:done",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "done",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-aborted-2e91",
+      "name": "terminal:aborted",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "aborted",
+        "kind": "failure"
+      }
+    }
+  ],
+  "connections": {
+    "s-chat-draft-9c12": {
+      "done": [
+        [
+          {
+            "step_id": "s-review-document-0d4a",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "timeout": [
+        [
+          {
+            "step_id": "s-terminal-aborted-2e91",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-review-document-0d4a": {
+      "approve": [
+        [
+          {
+            "step_id": "s-render-docx-a02a",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "request_changes": [
+        [
+          {
+            "step_id": "s-review-document-0d4a",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "max_loops_exceeded": [
+        [
+          {
+            "step_id": "s-terminal-aborted-2e91",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-render-docx-a02a": {
+      "done": [
+        [
+          {
+            "step_id": "s-terminal-done-f7c0",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "error": [
+        [
+          {
+            "step_id": "s-terminal-aborted-2e91",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-chat-draft-9c12"
+}

package/workflows/durable-memory-consolidation-v2.compound.json

@@ -0,0 +1,185 @@
+{
+  "schema_version": "lmctl/v3",
+  "definition_schema_version": 3,
+  "name": "durable-memory-consolidation-v2",
+  "version": 1,
+  "description": "Consolidates durable project memory from recent work so future sessions can recover important context quickly.",
+  "estimated_duration_ms": 180000,
+  "default_task_timeout_ms": 600000,
+  "steps": [
+    {
+      "id": "s-survey-93ff",
+      "name": "survey",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "parameters": {
+        "max_loops": 5
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "Read `<project>/durable-memory/index.md` and the full set of entries. Identify: (a) stale entries (referring to retired work, deleted features, obsolete decisions); (b) duplicated entries (same fact spread across multiple files); (c) orphan entries (no longer relevant to the current project state). Propose changes: list which to delete, which to merge, which to update. Output STANCE: `changes_proposed` (with proposal artifact) OR `all_clean` (no work needed)."
+        },
+        "reviewers": []
+      }
+    },
+    {
+      "id": "s-review-proposal-acb3",
+      "name": "review_proposal",
+      "type": "lmctl/interactive",
+      "typeVersion": 1,
+      "parameters": {
+        "termination": {
+          "operator_signal": true,
+          "max_turns": 5
+        }
+      },
+      "members": {
+        "agent": {
+          "team": "default",
+          "alias": "Coder",
+          "initial_prompt_template": "You just surveyed the durable-memory entries and proposed consolidation changes. Walk the operator through your proposal and wait for their decision (approve / reject / request edits). When the operator responds, acknowledge and proceed accordingly."
+        }
+      }
+    },
+    {
+      "id": "s-apply-changes-fad1",
+      "name": "apply_changes",
+      "type": "lmctl/review",
+      "typeVersion": 1,
+      "parameters": {
+        "max_loops": 5
+      },
+      "members": {
+        "coder": {
+          "team": "default",
+          "alias": "Coder",
+          "prompt_template": "Apply the approved consolidation changes to durable-memory. Use Write to update or delete entries under `<project>/durable-memory/`. Output STANCE: `applied` (with a brief summary of what changed) OR `failed` (with reason)."
+        },
+        "reviewers": []
+      }
+    },
+    {
+      "id": "s-terminal-no-action-d438",
+      "name": "terminal:no_action",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "no_action",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-max-iterations-ed61",
+      "name": "terminal:max_iterations",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "max_iterations",
+        "kind": "failure"
+      }
+    },
+    {
+      "id": "s-terminal-consolidated-9ef9",
+      "name": "terminal:consolidated",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "consolidated",
+        "kind": "success"
+      }
+    },
+    {
+      "id": "s-terminal-apply-failed-3898",
+      "name": "terminal:apply_failed",
+      "type": "lmctl/terminal",
+      "typeVersion": 1,
+      "parameters": {
+        "name": "apply_failed",
+        "kind": "failure"
+      }
+    }
+  ],
+  "connections": {
+    "s-survey-93ff": {
+      "approve": [
+        [
+          {
+            "step_id": "s-terminal-no-action-d438",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "changes_proposed": [
+        [
+          {
+            "step_id": "s-review-proposal-acb3",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "all_clean": [
+        [
+          {
+            "step_id": "s-terminal-no-action-d438",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-review-proposal-acb3": {
+      "done": [
+        [
+          {
+            "step_id": "s-apply-changes-fad1",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "timeout": [
+        [
+          {
+            "step_id": "s-terminal-max-iterations-ed61",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "s-apply-changes-fad1": {
+      "approve": [
+        [
+          {
+            "step_id": "s-terminal-consolidated-9ef9",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "applied": [
+        [
+          {
+            "step_id": "s-terminal-consolidated-9ef9",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ],
+      "failed": [
+        [
+          {
+            "step_id": "s-terminal-apply-failed-3898",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "entry_step_id": "s-survey-93ff"
+}