@lmctl-ai/lmctl 0.1.342 → 0.2.2

package/examples/n8n/multi-agent-review.lms

@@ -0,0 +1,107 @@
+# multi-agent-review.lms -- n8n Conversion: Hierarchical Multi-Agent Audit & Review Pipeline
+# Represents Shape 5: Supervisor / Multi-Agent Delegation (Decompose -> Specialist Workers -> Synthesizer)
+#
+# Usage:
+#   node dist/cli/index.js script examples/n8n/multi-agent-review.lms [teamfile]
+
+import "./agent-lib.lms";
+import "./git-lib.lms";
+
+teamfile = "examples/n8n/n8n-team.lmctl";
+if (len(args) > 0) { teamfile = args[0]; }
+
+repo = ".";
+head = git_head_short(repo);
+changed = git_changed(repo);
+
+print("=== Hierarchical Multi-Agent Review Pipeline (Shape 5) ===");
+print("Team: " + teamfile);
+print("Repository Head: " + head);
+print(format("Modified/Tracked Files: {0}", len(changed)));
+for (c = 0; c < min(5, len(changed)); c = c + 1) {
+  print("  - " + changed[c]);
+}
+print("");
+
+diff_summary = "Diff Overview:\n" +
+               "- Added LMScript wrappers for external commands (system curl/gh/sqlite3)\n" +
+               "- Implemented 5 n8n workflow conversions under examples/n8n/\n" +
+               "- Verified syntax and execution contracts";
+
+# --- Stage 1: Security Audit Specialist ---
+print("--- [Supervisor] Dispatching Stage 1: Security Audit ---");
+auditor_prompt = "You are a Specialist Security Auditor.\n" +
+                 "Evaluate the following architectural and code changes for security vulnerabilities, injection risks in system() calls, credentials leakage, and blast radius:\n\n" +
+                 diff_summary + "\n\n" +
+                 "List any vulnerabilities or confirm SECURITY_PASSED.\n" +
+                 "End your turn with DONE on its own last line.";
+
+res_sec = run_stage(teamfile, "Auditor", "security_audit", auditor_prompt);
+st_sec = res_sec[0];
+reply_sec = res_sec[1];
+
+if (needs_human(st_sec)) {
+  print("Security audit failed or requires human guidance. Stopping pipeline.");
+  lm_exit(1);
+}
+
+raw_sec = reply_sec;
+if (type(reply_sec) == "object" && has_key(reply_sec, "reply")) {
+  raw_sec = reply_sec.reply;
+}
+
+print("");
+
+# --- Stage 2: Code Quality & Architecture Review Specialist ---
+print("--- [Supervisor] Dispatching Stage 2: Quality & Architecture Review ---");
+reviewer_prompt = "You are a Senior Code Quality Reviewer.\n" +
+                  "Review the following changes for coding standards, type safety, modularity, and error handling:\n\n" +
+                  diff_summary + "\n\n" +
+                  "Security Audit Findings:\n" + raw_sec + "\n\n" +
+                  "Provide your review verdict (APPROVED or CHANGES_REQUESTED).\n" +
+                  "End your turn with DONE on its own last line.";
+
+res_rev = run_stage(teamfile, "Reviewer", "code_review", reviewer_prompt);
+st_rev = res_rev[0];
+reply_rev = res_rev[1];
+
+if (needs_human(st_rev)) {
+  print("Quality review failed or requires human guidance. Stopping pipeline.");
+  lm_exit(1);
+}
+
+raw_rev = reply_rev;
+if (type(reply_rev) == "object" && has_key(reply_rev, "reply")) {
+  raw_rev = reply_rev.reply;
+}
+
+print("");
+
+# --- Stage 3: Lead Synthesizer & Signoff ---
+print("--- [Supervisor] Dispatching Stage 3: Lead Synthesis & Final Signoff ---");
+lead_prompt = "You are the Team Lead.\n" +
+              "Review the findings from the Security Auditor and Quality Reviewer:\n\n" +
+              "Security Auditor Report:\n" + raw_sec + "\n\n" +
+              "Quality Reviewer Report:\n" + raw_rev + "\n\n" +
+              "Provide a concise final release recommendation and decision.\n" +
+              "End your turn with DONE on its own last line.";
+
+res_lead = run_stage(teamfile, "Lead", "lead_synthesis", lead_prompt);
+st_lead = res_lead[0];
+reply_lead = res_lead[1];
+
+if (needs_human(st_lead)) {
+  print("Lead synthesis requires human intervention.");
+  lm_exit(1);
+}
+
+raw_lead = reply_lead;
+if (type(reply_lead) == "object" && has_key(reply_lead, "reply")) {
+  raw_lead = reply_lead.reply;
+}
+
+print("");
+print("=== Final Pipeline Decision ===");
+print(raw_lead);
+print("");
+print("Multi-agent review pipeline complete.");

package/examples/n8n/news-digest.lms

@@ -0,0 +1,159 @@
+# news-digest.lms -- n8n Conversion: Scheduled Poll & Batched AI Digest
+# Represents Shape 3: Scheduled Cron -> Source Poll / Diff -> Batched LLM Transform -> Aggregate & Notify
+#
+# Usage:
+#   node dist/cli/index.js script examples/n8n/news-digest.lms [teamfile] [alias] [--dry-run]
+
+import "./agent-lib.lms";
+
+# --- External Service Wrappers over system() ---
+
+fn curl_fetch_json(url) {
+  cmd = format("curl -s -m 10 \"{0}\"", url);
+  out = system(cmd);
+  if (out[2] != 0 || len(trim(out[0])) == 0) {
+    return null;
+  }
+  return json_parse(trim(out[0]));
+}
+
+fn curl_post_webhook(url, body_json) {
+  cmd = format("curl -s -o /dev/null -w \"%{http_code}\" -m 10 -X POST -H \"Content-Type: application/json\" -d '{0}' \"{1}\"", body_json, url);
+  out = system(cmd);
+  return trim(out[0]);
+}
+
+# --- Main Script ---
+
+teamfile = "examples/n8n/n8n-team.lmctl";
+alias = "DigestAgent";
+dry_run = false;
+
+if (len(args) > 0) { teamfile = args[0]; }
+if (len(args) > 1) { alias = args[1]; }
+if (contains(args, "--dry-run")) { dry_run = true; }
+
+print("=== Scheduled Poll & Batched AI Digest (Shape 3) ===");
+print("Target: " + teamfile + ":" + alias);
+print("");
+
+# Step 1: Poll source items (fetch Hacker News top stories or use fallback feeds)
+print("[Step 1: Poll Source] Fetching top items via curl wrapper...");
+hn_ids = curl_fetch_json("https://hacker-news.firebaseio.com/v0/topstories.json");
+
+items_to_process = [];
+if (hn_ids != null && type(hn_ids) == "array" && len(hn_ids) > 0) {
+  # Take top 3 stories for the batch run
+  max_count = min(3, len(hn_ids));
+  print(format("  Discovered live feed. Fetching top {0} story details...", max_count));
+  for (idx = 0; idx < max_count; idx = idx + 1) {
+    id = hn_ids[idx];
+    story = curl_fetch_json(format("https://hacker-news.firebaseio.com/v0/item/{0}.json", id));
+    if (story != null && has_key(story, "title")) {
+      push(items_to_process, {
+        "title": story.title,
+        "url": get(story, "url", "https://news.ycombinator.com/item?id=" + str(id)),
+        "score": get(story, "score", 0)
+      });
+    }
+  }
+}
+
+# Fallback dataset if offline or network rate-limited
+if (len(items_to_process) == 0) {
+  print("  Using baseline feed items for batch transform...");
+  items_to_process = [
+    {
+      "title": "SQLite release 3.49 introduces enhanced JSONB performance",
+      "url": "https://sqlite.org/draft/releaselog/3_49_0.html",
+      "score": 412
+    },
+    {
+      "title": "Anthropic publishes model context protocol specification",
+      "url": "https://www.anthropic.com/news/model-context-protocol",
+      "score": 689
+    },
+    {
+      "title": "Zero-dependency CLI architectures in modern systems engineering",
+      "url": "https://example.com/blog/zero-dependency-cli",
+      "score": 185
+    }
+  ];
+}
+
+print(format("  Processing {0} items in batch transform loop.", len(items_to_process)));
+print("");
+
+# Step 2: Batched LLM Transform Loop (n8n SplitInBatches equivalent)
+digest_entries = [];
+
+for (i = 0; i < len(items_to_process); i = i + 1) {
+  item = items_to_process[i];
+  print(format("--- Transforming Item {0}/{1}: \"{2}\"", i + 1, len(items_to_process), item.title));
+
+  prompt_text = format(
+    "You are a technical news analyst preparing an executive briefing.\n" +
+    "Article Title: {0}\n" +
+    "URL: {1}\n" +
+    "Upvotes/Score: {2}\n\n" +
+    "Task: Provide a 1-sentence analytical summary and assign a topic tag (e.g., #AI, #Database, #Systems, #Security).\n" +
+    "Format as: [TAG] <One sentence summary>\n\n" +
+    "End your turn with DONE on its own last line.",
+    item.title, item.url, str(item.score)
+  );
+
+  res = run_stage(teamfile, alias, "transform_item_" + str(i + 1), prompt_text);
+  st = res[0];
+  reply_obj = res[1];
+
+  if (needs_human(st)) {
+    print("Batch item transformation failed. Stopping batch.");
+    lm_exit(1);
+  }
+
+  raw_reply = reply_obj;
+  if (type(reply_obj) == "object" && has_key(reply_obj, "reply")) {
+    raw_reply = reply_obj.reply;
+  }
+
+  # Clean summary line
+  sum_lines = lines(trim(raw_reply));
+  clean_summary = "";
+  for (line_idx = 0; line_idx < len(sum_lines); line_idx = line_idx + 1) {
+    curr_line = trim(sum_lines[line_idx]);
+    if (curr_line != "DONE" && len(curr_line) > 0) {
+      clean_summary = curr_line;
+      break;
+    }
+  }
+
+  push(digest_entries, format("- **[{0}]({1})** ({2} pts)\n  {3}", item.title, item.url, str(item.score), clean_summary));
+}
+
+# Step 3: Aggregate into formatted Markdown Digest
+print("");
+print("[Step 3: Aggregate & Publish] Assembling daily digest...");
+
+digest_content = "# Daily Engineering & AI Intelligence Digest\n\n" +
+                 "*Automated aggregation via LMScript (n8n Shape 3 pattern)*\n\n" +
+                 "### Top Stories & Analysis\n\n" +
+                 join(digest_entries, "\n\n") + "\n\n" +
+                 "---\n*Generated at unix epoch: " + str(clock()) + "*\n";
+
+digest_file = "examples/n8n/daily-digest.md";
+write_file(digest_file, digest_content);
+print("  Saved consolidated digest to " + digest_file);
+print("");
+
+# Step 4: Dispatch notification
+if (dry_run) {
+  print("[Step 4: Notify] [dry-run] Would POST digest to Slack webhook endpoint.");
+} else {
+  print("[Step 4: Notify] Sending notification to webhook endpoint via curl...");
+  webhook_payload = json_stringify({ "text": digest_content });
+  status = curl_post_webhook("https://hooks.slack.com/services/mock/endpoint", webhook_payload);
+  print("  Webhook dispatch returned HTTP status: " + status);
+}
+
+print("");
+print("Digest pipeline complete.");

package/examples/n8n/rag-search.lms

@@ -0,0 +1,163 @@
+# rag-search.lms -- n8n Conversion: Document Ingestion & Vector RAG Pipeline
+# Represents Shape 4: Document Ingestion & RAG (Chunk -> Embed -> Vector Store -> Top-k Retrieval -> Augmented LLM)
+#
+# Usage:
+#   node dist/cli/index.js script examples/n8n/rag-search.lms [teamfile] [alias]
+
+import "./agent-lib.lms";
+
+# --- External Embedding & Vector Wrappers over system() ---
+
+fn curl_get_openai_embedding(text, api_key) {
+  if (len(api_key) == 0) {
+    return { "error": "MISSING_API_KEY", "vector": [] };
+  }
+  payload = json_stringify({
+    "input": text,
+    "model": "text-embedding-3-small"
+  });
+  cmd = format("curl -s https://api.openai.com/v1/embeddings -H \"Authorization: Bearer {0}\" -H \"Content-Type: application/json\" -d '{1}'", api_key, payload);
+  out = system(cmd, 15000);
+  if (out[2] != 0 || len(trim(out[0])) == 0) {
+    return { "error": "CURL_FAILED", "details": trim(out[1]), "vector": [] };
+  }
+  res = json_parse(trim(out[0]));
+  if (res == null || !has_key(res, "data")) {
+    return { "error": "API_ERROR", "details": trim(out[0]), "vector": [] };
+  }
+  return { "error": null, "vector": res.data[0].embedding };
+}
+
+# Linear algebra vector math in LMScript
+fn cosine_similarity(v1, v2) {
+  if (len(v1) != len(v2) || len(v1) == 0) { return 0.0; }
+  dot = 0.0;
+  norm_a = 0.0;
+  norm_b = 0.0;
+  for (i = 0; i < len(v1); i = i + 1) {
+    dot = dot + (v1[i] * v2[i]);
+    norm_a = norm_a + (v1[i] * v1[i]);
+    norm_b = norm_b + (v2[i] * v2[i]);
+  }
+  denom = sqrt(norm_a) * sqrt(norm_b);
+  if (denom == 0.0) { return 0.0; }
+  return dot / denom;
+}
+
+# Document chunking primitive
+fn chunk_text_by_paragraphs(doc_text) {
+  raw_paras = split(doc_text, "\n\n");
+  chunks = [];
+  for (i = 0; i < len(raw_paras); i = i + 1) {
+    p = trim(raw_paras[i]);
+    if (len(p) > 20) {
+      push(chunks, p);
+    }
+  }
+  return chunks;
+}
+
+# --- Main Script ---
+
+teamfile = "examples/n8n/n8n-team.lmctl";
+alias = "RagAgent";
+if (len(args) > 0) { teamfile = args[0]; }
+if (len(args) > 1) { alias = args[1]; }
+
+# Check for API key in environment
+api_key = "";
+env_key = system("echo -n \"$OPENAI_API_KEY\"");
+if (len(trim(env_key[0])) > 0) {
+  api_key = trim(env_key[0]);
+}
+
+sample_doc = "# Antigravity Architecture Guide\n\n" +
+             "Antigravity uses a three-layer agent architecture: immutable role prompt, disposable session, and canonical durable-memory.\n\n" +
+             "The command-line interface lmctl is strictly stateless. Persistent daemon processes, time-series metrics, and background mail relays belong to the sibling tool lmbee.\n\n" +
+             "LMScript is an embedded scripting language executed via lmctl script. It provides core standard functions and lmctl orchestration host functions like lm_prompt and lm_members.\n\n" +
+             "Worktrees are used for isolated experimental branches. Bare git push is deliberately prevented on experimental branches until changes are reviewed and verified.";
+
+question = "Where do persistent background daemons and time-series metrics belong?";
+
+print("=== Document Ingestion & Vector RAG Pipeline (Shape 4) ===");
+print("Target: " + teamfile + ":" + alias);
+print("Question: \"" + question + "\"");
+print("");
+
+# Step 1: Document Chunking
+print("[Step 1: Chunking] Splitting document into semantic chunks...");
+chunks = chunk_text_by_paragraphs(sample_doc);
+print(format("  Generated {0} text chunks.", len(chunks)));
+print("");
+
+# Step 2: Vector Embedding Generation via external curl wrapper
+print("[Step 2: Vector Embeddings] Attempting to compute embeddings via curl_get_openai_embedding()...");
+emb_res = curl_get_openai_embedding(chunks[0], api_key);
+
+retrieved_context = "";
+
+if (emb_res.error != null) {
+  print("  External embedding call result: " + emb_res.error);
+  if (emb_res.error == "MISSING_API_KEY") {
+    print("  Notice: OPENAI_API_KEY is not set in environment.");
+  }
+  print("  [Fallback] Demonstrating lexical retrieval fallback because vector embeddings failed...");
+  # Fallback lexical similarity
+  best_match = "";
+  for (c_idx = 0; c_idx < len(chunks); c_idx = c_idx + 1) {
+    chk = chunks[c_idx];
+    if (contains(chk, "daemon") || contains(chk, "metrics")) {
+      best_match = chk;
+      break;
+    }
+  }
+  retrieved_context = best_match;
+} else {
+  print("  Vector embedding computed successfully. Vector dimension: " + str(len(emb_res.vector)));
+  # Vector retrieval path
+  q_emb = curl_get_openai_embedding(question, api_key);
+  best_score = -1.0;
+  best_chunk = chunks[0];
+  for (c_idx = 0; c_idx < len(chunks); c_idx = c_idx + 1) {
+    c_emb = curl_get_openai_embedding(chunks[c_idx], api_key);
+    score = cosine_similarity(q_emb.vector, c_emb.vector);
+    if (score > best_score) {
+      best_score = score;
+      best_chunk = chunks[c_idx];
+    }
+  }
+  print(format("  Top vector similarity score: {0}", best_score));
+  retrieved_context = best_chunk;
+}
+
+print("");
+print("--- Retrieved Context Chunk ---");
+print(retrieved_context);
+print("");
+
+# Step 3: Grounded Generation (Augmented Prompt)
+print("[Step 3: Grounded Generation] Calling agent with retrieved context...");
+rag_prompt = "You are a factual documentation assistant. Answer the user question strictly using the provided context.\n\n" +
+             "Context:\n\"" + retrieved_context + "\"\n\n" +
+             "Question: \"" + question + "\"\n\n" +
+             "Answer concisely and cite the context. End your turn with DONE on its own last line.";
+
+res = run_stage(teamfile, alias, "grounded_qa", rag_prompt);
+st = res[0];
+reply_obj = res[1];
+
+if (needs_human(st)) {
+  print("Grounded QA needs human assistance.");
+  lm_exit(1);
+}
+
+reply_text = reply_obj;
+if (type(reply_obj) == "object" && has_key(reply_obj, "reply")) {
+  reply_text = reply_obj.reply;
+}
+
+print("");
+print("--- Agent Response ---");
+print(reply_text);
+print("");
+print("RAG workflow complete.");

package/examples/n8n/support-agent.lms

@@ -0,0 +1,88 @@
+# support-agent.lms -- n8n Conversion: Tool-Using Support Agent Loop
+# Represents Shape 2: Conversational Trigger -> ReAct Agent Loop (Memory + Dynamic Tools) -> Response
+#
+# Usage:
+#   node dist/cli/index.js script examples/n8n/support-agent.lms [teamfile] [alias]
+
+import "./agent-lib.lms";
+
+# --- External Tool Wrappers over system() ---
+
+fn tool_sqlite_query(db_path, sql) {
+  cmd = format("sqlite3 -batch -json \"{0}\" \"{1}\" 2>&1", db_path, sql);
+  out = system(cmd);
+  if (out[2] != 0) {
+    return "Error executing query: " + trim(out[1]);
+  }
+  return trim(out[0]);
+}
+
+fn tool_search_kb(keyword, doc_dir) {
+  cmd = format("grep -rn -i -m 5 \"{0}\" \"{1}\" 2>/dev/null", keyword, doc_dir);
+  out = system(cmd);
+  return trim(out[0]);
+}
+
+fn tool_http_ping(host) {
+  cmd = format("curl -s -o /dev/null -w \"%{http_code}\" --connect-timeout 2 \"{0}\"", host);
+  out = system(cmd);
+  return trim(out[0]);
+}
+
+# --- Setup Mock Environment for the Agent's Tools ---
+
+mock_db = "examples/n8n/mock-support.db";
+# Ensure DB exists with sample schema
+init_sql = "CREATE TABLE IF NOT EXISTS orders (order_id TEXT PRIMARY KEY, customer_id TEXT, status TEXT, total REAL, item TEXT);" +
+           "INSERT OR REPLACE INTO orders VALUES ('ORD-9021', 'CUST-104', 'Shipped - In Transit', 85.00, 'Mechanical Keyboard');" +
+           "INSERT OR REPLACE INTO orders VALUES ('ORD-9022', 'CUST-208', 'Pending Fulfillment', 24.50, 'USB-C Cable Pack');";
+system(format("sqlite3 \"{0}\" \"{1}\"", mock_db, init_sql));
+
+# --- Main Script ---
+
+teamfile = "examples/n8n/n8n-team.lmctl";
+alias = "SupportAgent";
+if (len(args) > 0) { teamfile = args[0]; }
+if (len(args) > 1) { alias = args[1]; }
+
+customer_inquiry = "Customer CUST-104: Hi, can you check the status of my order ORD-9021? Also verify what item I ordered and the amount billed.";
+
+print("=== Conversational Support Agent with Dynamic Tools (Shape 2) ===");
+print("Target: " + teamfile + ":" + alias);
+print("Inquiry: " + customer_inquiry);
+print("");
+
+# Step 1: Execute tool lookup using external wrapper
+print("[Tool Action] Executing local database lookup via tool_sqlite_query()...");
+db_result = tool_sqlite_query(mock_db, "SELECT * FROM orders WHERE customer_id='CUST-104' OR order_id='ORD-9021';");
+print("  Tool Observation: " + db_result);
+print("");
+
+# Step 2: Dispatch turn to agent with customer inquiry and injected tool observation
+agent_prompt = "You are a Tier-1 Customer Support Specialist with access to internal database tools.\n" +
+               "Customer Inquiry:\n\"" + customer_inquiry + "\"\n\n" +
+               "Internal Database Tool Lookup Result:\n" + db_result + "\n\n" +
+               "Instructions:\n" +
+               "1. Provide a polite, professional, and accurate response to the customer using the tool observation.\n" +
+               "2. State the exact order status, item purchased, and total billed.\n" +
+               "3. End your turn with DONE on its own last line.";
+
+res = run_stage(teamfile, alias, "support_resolution", agent_prompt);
+st = res[0];
+reply_obj = res[1];
+
+if (needs_human(st)) {
+  print("Support turn needs human attention. Handing off.");
+  lm_exit(1);
+}
+
+reply_text = reply_obj;
+if (type(reply_obj) == "object" && has_key(reply_obj, "reply")) {
+  reply_text = reply_obj.reply;
+}
+
+print("");
+print("--- Final Customer Resolution ---");
+print(reply_text);
+print("");
+print("Support agent workflow complete.");

package/examples/n8n/ticket-triage.lms

@@ -0,0 +1,156 @@
+# ticket-triage.lms -- n8n Conversion: Inbound Ticket / Email Triager & Router
+# Represents Shape 1: Event Trigger -> LLM Classify & Extract -> Branch -> Action
+#
+# Usage:
+#   node dist/cli/index.js script examples/n8n/ticket-triage.lms [teamfile] [alias] [ticket_file] [--dry-run]
+
+import "./agent-lib.lms";
+
+# --- External Service Wrappers over system() ---
+
+fn gh_create_issue(repo, title, body, label) {
+  cmd = format("gh issue create -R \"{0}\" --title \"{1}\" --body \"{2}\" --label \"{3}\" 2>&1", repo, title, body, label);
+  out = system(cmd);
+  return [out[2], trim(out[0])];
+}
+
+fn post_webhook(url, payload_json) {
+  cmd = format("curl -s -o /dev/null -w \"%{http_code}\" -X POST -H \"Content-Type: application/json\" -d '{0}' \"{1}\"", payload_json, url);
+  out = system(cmd);
+  return trim(out[0]);
+}
+
+fn append_triage_log(log_path, record_json) {
+  return append_file(log_path, record_json + "\n");
+}
+
+# --- Main Script ---
+
+teamfile = "examples/n8n/n8n-team.lmctl";
+alias = "TriageAgent";
+ticket_file = "";
+dry_run = false;
+
+if (len(args) > 0) { teamfile = args[0]; }
+if (len(args) > 1) { alias = args[1]; }
+if (len(args) > 2) { ticket_file = args[2]; }
+if (contains(args, "--dry-run")) { dry_run = true; }
+
+# Sample payload if no file provided
+ticket_text = "Subject: Urgent: Database connection pool exhausted in production\n" +
+              "From: ops@example.com\n" +
+              "Body: Starting at 02:15 UTC, the main PostgreSQL cluster reached 100% max_connections. Web app is throwing 500 errors on checkout flow. Please investigate immediately.";
+
+if (len(ticket_file) > 0 && file_exists(ticket_file)) {
+  ticket_text = read_file(ticket_file);
+}
+
+print("=== Inbound Ticket Triage & Router (Shape 1) ===");
+print("Target: " + teamfile + ":" + alias);
+print("Ticket preview: " + trim(substring(ticket_text, 0, min(80, len(ticket_text)))) + "...");
+print("");
+
+triage_prompt = "You are an automated customer support & issue triage router.\n" +
+                "Analyze the following incoming ticket and produce structured JSON classification.\n\n" +
+                "Incoming Ticket:\n" + ticket_text + "\n\n" +
+                "Respond with ONLY a valid JSON object matching this schema (no markdown fences, no extra text):\n" +
+                "{\n" +
+                "  \"category\": \"bug\" | \"security\" | \"billing\" | \"feature\" | \"ops\",\n" +
+                "  \"urgency\": 1 to 5,\n" +
+                "  \"summary\": \"one-sentence summary\",\n" +
+                "  \"recommended_action\": \"action description\"\n" +
+                "}\n\n" +
+                "End your turn with DONE on its own last line.";
+
+# Reusing agent-lib's run_stage
+res = run_stage(teamfile, alias, "triage_classification", triage_prompt);
+st = res[0];
+reply_obj = res[1];
+
+if (needs_human(st)) {
+  print("Triage requires human intervention. Halting.");
+  lm_exit(1);
+}
+
+reply_text = reply_obj;
+if (type(reply_obj) == "object" && has_key(reply_obj, "reply")) {
+  reply_text = reply_obj.reply;
+}
+
+# Extract JSON from reply (strip state line and optional markdown fences)
+reply_lines = lines(trim(reply_text));
+clean_json_lines = [];
+i = 0;
+while (i < len(reply_lines)) {
+  l = trim(reply_lines[i]); i = i + 1;
+  if (l == "DONE" || l == "NOTHING_TO_DO" || l == "BLOCKED" || l == "OTHER") { continue; }
+  if (starts_with(l, "```")) { continue; }
+  push(clean_json_lines, l);
+}
+clean_json_text = join(clean_json_lines, "\n");
+
+triage = json_parse(clean_json_text);
+if (triage == null) {
+  print("Failed to parse LLM structured triage output. Raw output:");
+  print(clean_json_text);
+  lm_exit(1);
+}
+
+category = triage.category;
+urgency = num(triage.urgency);
+summary = triage.summary;
+action = triage.recommended_action;
+
+print("");
+print("--- Triage Decision Matrix ---");
+print("  Category: " + category);
+print("  Urgency:  " + str(urgency) + "/5");
+print("  Summary:  " + summary);
+print("  Action:   " + action);
+print("");
+
+# Branch 1: High Urgency (>= 4) -> Trigger Webhook Alert
+if (urgency >= 4) {
+  print("[Route: High Urgency] Disagreeable or critical issue detected -> Dispatching Alert Webhook...");
+  alert_payload = json_stringify({
+    "event": "incident_alert",
+    "urgency": urgency,
+    "summary": summary,
+    "ticket": ticket_text
+  });
+  if (dry_run) {
+    print("  [dry-run] Would post alert payload to https://alert.example.com/webhook");
+  } else {
+    code = post_webhook("https://alert.example.com/webhook", alert_payload);
+    print("  Webhook dispatch returned HTTP status: " + code);
+  }
+}
+
+# Branch 2: Bug or Ops or Security -> File Issue via gh wrapper
+if (category == "bug" || category == "ops" || category == "security") {
+  print("[Route: Engineering Ticket] Opening tracking issue via `gh` wrapper...");
+  issue_title = "[" + category + "] " + summary;
+  issue_body = "Automated Triage from Ticket\n\nUrgency: " + str(urgency) + "\n\n" + ticket_text;
+  issue_label = category;
+  
+  if (dry_run) {
+    print("  [dry-run] Would execute: gh issue create -R \"example/repo\" --title \"" + issue_title + "\" --label \"" + issue_label + "\"");
+  } else {
+    gh_res = gh_create_issue("example/repo", issue_title, issue_body, issue_label);
+    print("  gh command exit code: " + str(gh_res[0]) + ", output: " + gh_res[1]);
+  }
+} else {
+  # Branch 3: Billing / Feature -> Append to business queue ledger
+  print("[Route: Business Queue] Appending to internal triage ledger...");
+  log_entry = json_stringify({
+    "timestamp": clock(),
+    "category": category,
+    "urgency": urgency,
+    "summary": summary
+  });
+  append_triage_log("examples/n8n/triage-ledger.jsonl", log_entry);
+  print("  Appended to examples/n8n/triage-ledger.jsonl");
+}
+
+print("");
+print("Triage workflow execution complete.");